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内 容 简 介 


本 书 以 Web 服务 技术 的 原理 为 主线 , 详细 讲解 在 .NET 平台 上 的 实现 方式 内 容 涵盖 Web 服务 的 基础 概念 、 
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前 言 


随 着 互联 网 技术 的 不 断 发 展 ， 越 来 越 多 的 应 用 程序 需要 集成 在 Intemet 中 。 信 息 在 网 络 中 
进行 传递 ， 需 要 适应 不 同 的 网 络 环境 ， 在 不 同 的 网 络 平台 之 间 实 现 通信 的 兼容 。 

Web 服务 是 基于 网 络 的 一 种 软件 开发 模式 。 它 通过 规范 性 的 设计 、 发 布 、 实 现 和 调用 ， 可 
以 实现 多 个 Web 服务 构建 成 一 个 完整 的 应 用 程序 功能 。 

本 书 详细 介绍 了 Web 服务 的 概念 及 其 相关 的 协议 和 技术 规范 。 然 后 通过 C# 编 写 一 些 实现 
Web 服务 的 解决 方案 , 并 使 用 一 些 针 对 性 和 应 用 性 较 强 的 案例 来 加 深 读 者 对 Web 服务 的 理解 。 


本 书 内 容 


第 1 章 Web 服务 入 门 知识 。 本 章 主要 介绍 什么 是 Web 服务 、Web 服务 的 优势 、Web 服 
务 的 技术 架构 ， 以 及 Web 服务 在 .NET 平台 中 的 简单 用 法 。 

第 2 章 构建 ASPNET Web 服务 。 本 章 将 学 习 创建 Web 服务 的 各 种 方法 ， 并 重点 介绍 用 
Visual Studio 创建 ASP.NET Web 服务 和 修改 Web 服务 属性 的 方法 。 

第 3 章 Web 服务 基础 知识 之 XML 技术 。 本 章 详细 介绍 Web 服务 基础 中 有 关 XML 的 知 
识 ， 包 括 XML 声明 、XML 属性 、XML 命名 空间 、XML 的 实体 引用 以 及 DTD 等 。 

第 4 章 Web 服务 类 型 系统 一 一 XSD。 本 章 详细 介绍 在 Web 服务 中 检验 XML 数据 正确 性 
的 一 个 机 制 XSD， 包 括 定义 简单 和 复杂 的 数据 类 型 、 匿 名 类 型 以 及 验证 XSD 等 。 

第 5 章 Web 服务 描述 语言 。 本 章 将 会 对 WSDL 进行 详细 的 讲解 ， 包 括 如 何 查看 WSDL 
文档 、WSDL 文档 的 结构 ， 以 及 WSDL 的 各 个 组 成 部 分 等 。 

第 6 章 简单 对 象 访问 协议 一 一 SOAP。 本 章 深入 讲解 ASP.NET Web 服务 中 SOAP 协议 
的 应 用 ， 包 括 SOAP 的 报头 和 主体 、SOAP 传递 消息 和 扩展 等 。 

第 7 章 管理 Web 服务 的 状态 。 本 章 讲解 在 设计 Web 服务 时 ， 如 何 对 客户 端的 状态 信息 
进行 保存 和 管理 ， 包 括 使 用 Session、Application 和 Cookie 等 。 

第 8 章 异步 服务 。 本 章 将 深入 学 习 基 于 ASPNET Web 服务 的 同步 化 调用 和 异步 化 调用 。 

第 9 章 利用 ASPNET 的 缓存 和 事务 功能 。 本 章 将 讲解 如 何 为 Web 服务 添加 缓存 和 事务 
功能 ， 包 括 ASPNET 缓存 机 制 、 输 出 缓存 、 应 用 程序 缓存 以 及 事务 的 使 用 等 。 

第 10 章 安全 性 和 验证 。 本 章 将 深入 讲解 ASP.NET 中 关于 Web 服务 的 身份 验证 、 授 权 
机 制 ， 以 及 使 用 SOAP 实现 安全 通信 的 技术 ， 以 保护 Web 服务 的 安全 等 。 

第 11 章 NET 下 的 XML 操作 。 本 章 将 学 习 如 何在 ASP.NET 中 读 取 和 写 入 XML、XML 
的 属性 和 节点 的 增删 改 操作 ， 以 及 XML 序列 化 等 。 

第 12 章 集成 第 三 方 Web 服务 。 本 章 介绍 如 何 使 用 网 络 中 提供 的 一 些 现 有 的 Web 服务 ， 
以 及 把 这 些 Web 服务 集成 到 一 个 Web 应 用 程序 中 。 

第 13 章 WCF 快速 入 门 。 本章 将 介绍 什么 是 WCF、WCF 的 基本 术语 以 及 如 何 创 建 WCF 
和 编写 客户 端 代码 。 


第 14 章 ”网络 聊天 工具 。 本 章 我 们 将 在 Windows Form 中 使 用 Web 服务 来 开发 一 个 简单 
的 网 络 聊天 工具 ， 实 现 注 册 、 登 录 、 添 加 好 友 、 发 送 消 息 和 文件 以 及 监听 等 功能 。 

第 15 章 ”留言 簿 。 本 章 主要 介绍 如 何 使 用 ASP.NET 结合 Web 服务 实现 留言 短 ， 功 能 
括 添加 留言 、 管 理 员 登录 、 回 复 和 删除 留言 等 。 


本 书 特色 


本 书 中 的 大 量 内 容 来 自 真实 的 Web 服务 项 目 ， 力 求 通过 对 读者 实际 操作 时 的 问题 进行 描 
述 并 加 以 解决 的 方法 使 读者 更 轻松 地 掌握 Web 服务 的 开发 。 本 书 难 度 适中 ， 内 容 由 浅 入 深 、 
实用 性 强 、 覆 盖 面 广 、 条 理 清晰 。 

1) ”结构 独特 

通过 “网 络 教学 一 基础 知识 一 实例 描述 一 实例 应 用 一 运行 结果 一 实例 分 析 ” 的 形式 将 每 个 
知识 与 实际 应 用 中 的 问题 相 结 合 。 

2) ”形式 新 颖 

用 准确 的 语言 总 结 概念 、 用 直观 的 图 示 演示 过 程 、 用 详细 的 注释 解释 代码 、 用 形象 的 比喻 
帮助 记忆 。 

3) ”技术 文档 

技术 文档 包含 一 些 非常 简单 的 知识 点 或 者 理论 性 的 内 容 。 通常 这 些 内 容 没 有 具体 的 应 用 案 
例 ， 但 又 是 读者 必须 要 了 解 的 ， 例 如 一 些 概念 和 术语 。 

4) ”内容 丰富 

涵盖 了 实际 开发 中 Web 服务 技术 中 涉及 的 XML 技术 、XSD、WSDL、SOAP、Web 服务 
状态 、 异 步 服 务 、 缓 存 、 事 务 、 安 全 性 和 验证 技术 、WGCF 等 方面 的 各 种 问题 。 

5) ” 随 书 光盘 

本 书 为 实例 配备 了 视频 教学 文件 ， 读 者 可 以 通过 视频 文件 更 加 直观 地 学 习 Web 服务 的 使 
用 知识 。 

6) ”网 站 技术 支持 

读者 在 学 习 或 者 工作 的 过 程 中 ， 如 果 遇 到 问题 ， 可 以 直接 登录 www.itzcn.com 与 我 们 取得 
联系 ， 作 者 会 在 第 一 时 间 给 予 帮助 。 

) 7) 贴心 的 提示 
为 了 便于 读者 阅读 ， 全 书 还 穿插 着 一 些 技巧 、 提 示 等 小 贴 士 ， 体 例 约定 如 下 。 

提示 : 通常 是 一 些 贴 心 的 提醒 ， 让 读者 加 深 印 象 或 提供 建议 和 解决 问题 的 方法 。 

注意 : 提出 学 习 过 程 中 需要 特别 注意 的 一 些 知识 点 和 内 容 ， 或 者 相关 信息 。 

技巧 : 通过 简短 的 文字 ， 指 出 知识 点 在 应 用 时 的 一 些小 窍门 。 

读者 对 象 

本 书 具 有 知识 全 面 、 实 例 精 彩 、 指 导 性 强 的 特点 ， 力 求 以 全 面 的 知识 性 及 丰富 的 实例 来 指 
导读 者 透彻 地 学 习 Web 服务 各 方面 的 知识 。 本 书 可 以 作为 Web 服务 的 入 门 书籍 ， 也 可 以 帮助 
中 级 读者 提高 技能 ， 对 高 级 读者 也 有 一 定 的 启发 意义 。 

本 书 适合 以 下 人 员 阅 读 学 习 : 

@ Web 服务 初学 者 以 及 在 校 学 生 

@ ”Web 应 用 程序 开发 人 员 


El >> 


@ ”各 大 中 专 院 校 的 相关 授课 老师 

@ ”其 他 使 用 Web 服务 的 从 业 人 员 

参 编 人 员 

本 书 主 要 由 闫 建 强 、 王 瑞 敬 编写 , 其 他 参与 编写 、 资料 整理 、 程 序 开发 的 人 员 还 有 赵 俊昌 、 
张 芳 芳 、 杨 飞 、 赵 振 方 、 胡 海 静 、 秦 方 、 杨 晓 军 、 侯 俊杰 等 。 

由 于 编者 水 平 有 限 ， 书 中 难免 存在 不 足 和 下 漏 之 处 ， 奶 请 读者 批评 指正 。 


< 


第 2 章 


Web 服务 入 门 知识 . 
访问 网 络 中 的 Web 服务 … 
9 
?视频 教学 : 13 分 钟 . 
在 .NET 中 使 用 Web 服务 
9 
视频 教学 : 9 分钟 
2 
1.2.2 ”实例 应 用 .… 
1.2.3 运行 结果 … 
1.2.4 实例 分 析 
为 什么 使 用 Web 服务 


cS 视频 教学 : 9 分 钟 ….……………….…..10 
1.3.1 基础 知识 一 一 Web 服务 的 
EE 10 
1.3.2 ”实例 描述 … 
1.3.3 ”实例 应 用 ..… 
1.3.4 ”实例 分 析 
Web 服务 的 技术 架构 


| 
BD 视频 教学 : 8 分钟 …………….15 
使 用 ASP.NET 构建 一 个 Web 服务 …..18 


< 视频 教学 : 6 分 钟 18 
1.5.1 实例 描述 … 
1.5.2 ”实例 应 用 … 
1.5.3 运行 结果 … 
1.5.4 ”实例 分 析 .… 
常见 问题 解答 
1.6.1 什么 是 Web Service 
1.6.2 Web Service 和 Web Server 


使 用 记事 本 创建 Web 服务 .26 
9 
ES 视频 教学 : 13 分 钟 .26 


22 


2.3 


2.4 


2.5 


2.1.1 基础 知识 一 一 WebService 处 理 
pA be 


2.13 
2.1.4 
2.1.5 运 和 
2.1.6 ”实例 分 析 
从 命令 行 执行 Web 服务 
只 视频 教学 : 6 分 钟 … 人 
2.2.1 基础 知识 一 一 创建 代理 类 .……. 29 
2.2.2 ”基础 知识 一 一 使 用 命令 生成 
代理 已 -< 
2.2.3 ”实例 描述 
2.2.4 实例 应 用 
225 


2.2.6 
实现 用 户 登 录 验 证 的 Web 服务 ……… 
cr 视频 教学 : 9 分钟 ………………. 35 
2.3.1 基础 知识 一 一 利用 Visual Studio 
创建 Web 服务 .es 35 
2.3.2 ”实例 描述 
2.3.3 实例 应 用 
2.3.4 运行 
2.3.5 a 
使 用 ASP.NET 测试 Web 服务 ………… 39 
EN 视频 教学 : 14 分钟 …………… 39 
2.4.1 基础 知识 一 一 添加 服务 引用 
与 Web 引用 的 区 别 .. 
2.4.2 ”实例 描述 


2.4.3 ”实例 应 用 
2.4.4 运行 


2.4.5 
创建 万 年 历 Web 服务 


2.6 


2.7 


2.8 


第 3 章 


Each >> 


3.1 


3 


人 视频 教学 : 10 分 钟 ….……….46 
2.5.1 基础 知识 一 一 WebService 

属性 .. .46 
2.5.2 ”实例 描述 
2.5.3 ”实例 应 用 
2.5.4 运行 结果 
2.5.5 ”实例 分 析 .… 
为 Web 服务 方法 添加 说 明 
= 视频 教学 : 10 分 钟 ……………………… 50 
2.6.1 基础 知识 一 一 WebMethod 


2.6.2 
2.6.3 ”实例 应 用 .… 
2.6.4 运行 结果 … 
2.6.5 实例 分 析 … 
常见 问题 解答 


2.7.1 如 何 生成 代理 类 ， 如 何 创 建 

一 个 Web 服务 .pe 57 
2.7.2 添加 Web 服务 引用 时 的 

问题 Ey 
2.7.3 ”如何 调试 Web 服务 .pp 58 
2.7.4 Web Service 为 什么 没有 url 

并 人 a 58 
2.7.5 WebMethod 和 WebMethod0) 

有 什么 区 别 
Web 服务 基础 知识 之 XML 
技术 en 63 
EE XML waonansaanaad 64 

9 

?视频 教学 : 6 分 钟 …… 


创建 一 个 简单 的 XML 文档 .… 


六 
视频 教学 : 12 分 钟 ….……….65 
3.2.1 基础 知识 一 一 XML 的 声明 和 


> 65 
3.2.2 ”基础 知识 一 一 XML 的 标记 与 

二 66 
323 汪 拓 绚 克 。 wwe 68 


3.4 


A 
让 = ”视频 教学 : 6 分钟 


展示 个 性 的 名 言 警句 ………….… 71 
9 
视频 教学 : 9 分 钟 72 


3.4.1 基础 知识 一 一 XML 命名 


3.4.2 ”实例 描述 


3.6 


7 


.52 


3.5.3 
3.5.4 
js 
3.5.6 
制作 精彩 的 树 状 后 台 
ca 视频 教学 : 27 分 钟 .. 三 
3.6.1 基础 知识 一 一 文档 类 型 定义 


3.6.2 ”实例 描述 
3.6.3 ”实例 应 用 
3.6.4 运行 结果 
3.6.5 实例 分 析 


常见 问题 解答 … 

3.7.1 关于 XML 中 命名 空间 的 
PE 94 

3.7.2 XML 中 的 CDATA 区 和 注释 
EL 95 


3.7.3 XML 文件 引用 外 部 DTD 文件 
| 


第 4 章 


4.3 


4.4 


4.5 


4.6 


4.7 


2 VP 96 
Web 服务 类 型 系统 一 一 XSD.……99 
和 入 汪汪 Dee 100 
a 00 


外 
?视频 教学 :5 分 钟 
4.1.2 ”基础 知识 一 一 XSD 简介 . 
根据 XML 文件 定义 简易 元 素 


9 
村 ww? 视频 教学 : 9 分 钟 …… 


4.2.1 基础 知识 一 一 定义 简易 

元 素 .. 101 
4.2.2 ”实例 描述 103 
4.2.3 实例 应 用 103 
4.2.4 运行 结果 104 
4.2.5 实例 分 析 … 105 


攻 
于 "视频 教学 :17 分 钟 
基础 知识 一 一 定义 简单 数据 


4.3.1 


4.3.2 
4.3.3 
4.3.4 运行 结果 … 
4.3.5 实例 分 析 … 
定义 匿名 类 型 


司 
于 视频 教学 : 3 分 钟 …… 111 
专辑 信息 .asseseaasuasaasaas 


二 
匡 w 2 视频 教学 : 15 分钟. 


4.5.1 基础 知识 一 一 复杂 数据 

类 型 .. 113 
4.5.2 ”实例 描述 .120 
4.5.3 ”实例 应 用 .… .120 
4.5.4 ”运行 结果 .… sil 
4.5.5 实例 分 析 
构造 XSD 的 元 素 和 属性 


ci 视频 教学 : 12 分钟 
4.6.1 基础 知识 一 一 声明 元 素 .. 
4.6.2 ”基础 知识 一 一 声明 属性 .. 
编写 程序 验证 XSD 文档 .……………- 


4.8 


4.9 


$2 


可 


128 


入 
本 ' 视频 教学 :5 分 钟 
4.7.1 基础 知识 一 一 指定 XSD 


位 置 … 
实例 描述 
实例 应 用 
运行 结果 
4.7.5 实例 分 析 
使 用 二 进 制 数据 
局 视频 教学 : 6 分 钟 
4.8.1 实例 描述 
4.8.2 ”实例 应 用 


4.7.2 
4.7.3 
4.7.4 


4.8.4 实例 分 析 
常见 问题 解答 … 
4.9.1 DTD 与 XSD 的 区 别 .… 
4.9.2 定义 simpleType 的 问题 ……… 
4.9.3 用 XML Schema 规范 XML 


2 137 
en 138 
Web 服务 描述 语言 ……………… 141 
全 和 是 WDD 
人 
ED 视频 教学 :6 分 钟 
剖析 WSDL 文档 结构 … 
9 
视频 教学 :18 分 钟 144 


5.2.1 基础 知识 一 一 WSDL 文档 


S23 
Sa 
5.2.4 运行 
2 
WSDL 文档 元 素 ……………… 


但 
EL 视频 教学 : 27 分 钟 . 


5.3.1 基础 知识 一 一 definitions 根 

元 素 50 
5.3.2 ”基础 知识 一 一 types 元 素 .……151 
5.3.3 基础 知识 一 -message 元 素 .… 153 
5.3.4 基础 知识 一 一 portType 元 素 .… 154 


< 


m= 办) >> 


5.4 


5.5 


6.1 


6.2 


6.3 


5.3.5 ”基础 知识 一 binding 元 素 .….156 


5.3.6 ”基础 知识 一 一 service 元 素 .……158 

碍 询 妨 必 池 季 针 nmi 158 
9 

ES 视频 教学 : 12 分 钟 ……….158 

5.4.1 基础 知识 一 一 WSDL 文档 的 

5.4.2 

5.4.3 

5.4.4 运行 结果 

5.4.5 实例 分 析 i 

常见 问题 解答 ……. 162 

5.5.1 关于 自 定义 WSDL 的 问题 …..162 

5.5.2 ”如 何 处 理 WSDL 中 的 复杂 

a 163 

| 164 

简单 对 象 访问 协议 一 一 

AR 167 

全 面 认识 SOAP. samen 168 
9 

视频 教学 : 28 分钟. 168 

6.1.1 基础 知识 一 一 为 什么 我 们 要 


ce 视频 教学 : 12 分钟. 
SOAP 的 RPC 规定. 
6.2.2 RPC 和 HTTP...... 
使 用 Web 服务 上 传 和 下 


9 
,视频 教学 : 18 分 钟 
63.1 基础 知识 一 一 传递 特殊 的 


6.2.1 


6.3.2 


6.3.3 
6.3.4 运行 


6.4 


6.3.5 ”实例 分 析 … 
隐藏 用 户 的 隐私 信 


< 视频 教学 : 23 分钟 …………… 183 
基础 知识 一 一 定制 SOAP 

机 183 
实例 描述 … 
实例 应 用 .… 
运行 结果 .… 


6.4.1 


6.6 


6.7 
第 7 章 


| 


ye 


和 3 


ca 视频 教学 : 32 分 钟 …………………… 
6.5.1 基础 知识 一 一 SOAP 扩展 .……… 
6.532” 实例 描述 .sscssssss 
6.5.3 ”实例 应 用 .… 
6.5.4 ”运行 结果 .… 
6.5.5 ”实例 分 析 .… 
常见 问题 解答 
6.6.1 SOAP 概念 的 问题 200 
6.6.2 SOAP 协议 是 否 可 以 进行 文件 
传输 .… 


习题 . 
管理 Web 服务 的 状态 ……………… 203 


Web 服务 状态 管理 分 析 ………………… 204 
ce 视频 教学 : 7 分 钟 
记录 操作 日 志 的 简单 计算 器 . 
We 视频 教学 : 23 分 钟 ………… 206 
7.2.1 基础 知识 一 一 会 话 管理 

凤 半 Soni 206 
实例 描述 … 
实例 应 用 
7.2.4 运行 


7.2.2 


7.2.3 


72.5 


入 
视频 教学 :13 分 钟 214 
7.3.1 基础 知识 一 一 应 用 程序 对 象 
本 


214 


7.4 


人 


7.6 
第 8 章 


8.1 


8.2 


8.3 


8.4 


ns 216 
实例 应 用 .… 
3 217 
在 Web 服务 客户 端 保存 用 户 状态 …… 
ce 视频 教学 : 17 分 钟 
7.4.1 基础 知识 一 一 Cookie 对 象 
7.4.2 ”实例 描述 … 
7.4.3 
7.4.4 运行 
7.4.5 
常见 问题 解答 a 
7.5.1 在 Web 服务 中 是 否 可 以 保持 

2 223 
7.5.2 ”WebService.asmx 如 何 使 用 


Session ... 


3 


7.3.4 


Web 服务 的 性 能 测试 
ca 视频 教学 : 7 分 钟 … 
8.1.1 实例 描述 … 
8.1.2 ”实例 应 用 
8.1.3 运行 结果 
8.1.4 实例 分 析 
实现 异步 调用 Web 服务 验证 用 户 

1 230 


9 
:视频 教学 :13 分 钟 ….………..230 
8.2.1 基础 知识 一 一 异步 调用 Web 


实例 描述 .… 
实例 应 用 ... 
运行 结果 .… 
8.2.5 ”实例 分 析 .… RE 
异步 调用 和 同步 调用 的 比较 ….……….236 
9 
视频 教学 :10 分钟 . 
异步 用 户 信息 查询 服务 a 
9 
视频 教学 : 13 分 钟 . .239 


8.2.2 
8.2.3 


8.2.4 


8.5 


8.6 


8.7 


第 9 章 


hl 


92 


全 3 


上 “:::““ “  ““ “ “ 


8.4.1 基础 知识 一 一 使 用 回调 ………… 239 
实例 描述 
实例 应 用 


8.44 运 


8.4.2 


8.4.3 


8.4.5 

设计 Web 服务 需要 考虑 的 事项 
9 

EL 视频 教学 :10 分钟.…. 

8.5.1 基础 知识 一 一 超时 间 题 的 


处 理 … .245 
8.5.2 ”实例 描述 ..246 
8.5.3 ”实例 应 用 ..246 
8.5.4 运行 结果 .247 
8.5.5 实例 分 析 .248 
常见 问题 解答 … .248 
8.6.1 NET 中 Web 服务 是 同步 调用 

还 是 异步 调用 248 
8.6.2 关于 Web 服务 异步 回调 的 

问题 
习题 .. ee 
利用 ASP.NET 的 缓存 和 事务 
WHE eam 251 
了 解 ASP.NET 缓存 机 制 ………………… 252 
a 视频 教学 : 4 分 钟 5 
使 用 输出 缓存 保存 文件 内 容 .253 


9 
是 视频 教学 : 11 分 钟 
9.2.1 基础 知识 一 一 使 用 输出 


9.2.2 ”实例 描述 
9.2.3 ”实例 应 用 
9.2.4 
9.2.5 
管理 缓存 的 数据 ………… 258 


< 视频 教学 : 16 分 钟 ……… 258 
9.3.1 基础 知识 一 一 使 用 应 用 程序 

9.3.2 ”实例 描述 时 
Li 262 


EX 


mf >> 


9.4 


3 


9.6 


9.7 


9.8 


9 


i RN 266 
9.3.5 ”实例 分 析 
解决 各 个 缓存 间 的 依赖 性 . 
人 视频 教学 : 10 分 钟 
为 删除 缓存 项 指定 回调 函数 
a 视频 教学 : 11 分 钟 
基础 知识 一 一 缓存 回调 


3 


实例 描述 .… 
实例 应 用 … 
9.5.4 运行 结果 … 
9.5.5 ”实例 分 析 .… ee 
使 用 缓存 时 的 注意 事项 
"= 视频 教学 : 6 分 钟 
了 解 事务 的 并 发 机 制 … 
i 视频 教学 : 10 分 钟 
为 Web 服务 启用 事务 功能 
a 视频 教学 : 4 分 钟 加 
全 出 问 题 朋 答 SsaesRaeese 
9.9.1 设置 Web 服务 的 响应 时 间 和 
数据 传输 长 度 i 
9.9.2 ”Web 服务 中 更 新 缓存 问题 …… 


32 
EA 


i 283 
第 10 章 “安全 性 和 验证 pe 287 


10.1 


了 解 Web 服务 安全 机 制 …………….288 


9 
视频 教学 ， 18 分钟. 288 
10.1.1 基础 知识 一 一 什么 是 安全 


288 
10.1.2 ”基础 知识 一 一 Web 服务 的 
家 全体 其 sD 288 
10.1.3 ”基础 知识 一 一 与 Web 服务 
有 关 的 安全 选项 .… 


10.1.4 Web 服务 安全 层 .. 


10.2 ”使 用 Windows 验证 来 限制 用 户 


9 
视频 教学 : 13 分 钟 …….292 


10.2.1 


10.2.2 
10.23 
10.2.4 
10.2.5 
10. 


已 


呈 
10.4 
吧 


10.4.1 


10.4.2 
10.4.3 
10.4.4 
10.4.5 
实现 
Ne 


10.5.1 


10.5.2 
10.5.3 
10.5.4 
10.5.5 
10.6 


使 用 表单 验证 进行 权限 过 滤 .. 


常见 问题 解答 .. 


基础 知识 一 一 集成 Windows 


实例 描述 
实例 应 用 .… 
运行 结果 .… 


视频 教学 :5 分 钟 ………………… 


禁止 使 用 浏览 器 访问 Web 服务 …… 


视频 教学 : 16 分 钟 …………… 298 
基础 知识 一 一 禁用 GET、 


实例 应 用 .… 
运行 结果 .… 
实例 分 析 .… 
自 定义 验证 的 Web 服务 ………… 302 


视频 教学 ，13 分 钟 ……………… 302 
基础 知识 一 一 自 定义 SOAP 


实例 描述 
实例 应 用 .… 
运行 结果 .… 
实例 分 析 … 


10.6.1 如 何 设 计 安 全 的 Web 服务 …307 


10.6.2 


Web 服务 的 安全 体系 .…………. 308 


11.1 从 XML 文件 中 读 取 新 闻 .…………… 312 


My 
11.1.2 
3 
11.1.4 
M5 
112 入 


视频 教学 : 13 分钟 ……………… 312 
基础 知识 一 一 读 取 XML.……312 
实例 描述 … 
实例 应 用 .… 
运行 结果 .… 
实例 分 析 … 攻 

XML 的 收 件 箱 -pp 320 


1 


已 


11.4 


11. 


牧 时 
上 视频 教学 : 15 分 钟 


320 
11.2.1 基础 知识 一 一 写 入 XML .……320 
2 类 本 拓 坟 wwe 325 
11.2.3 实例 应 用 .… .325 
11.2.4 运行 结果 … 
ii 
宠物 信息 的 增删 改 操作 i 
a 视频 教学 : 10 分 钟 ….…..……………..328 
11.3.1 实例 描述 .… .328 
11.3.2 ”实例 应 用 … 
11.3.3 运行 结果 .… 
11.3.4 ”实例 分 析 .… 332 
自 定义 XML 序列 化 ee 
Eu 视频 教学 : 10 分 钟 333 
常见 问题 解答 .pe 336 
11.5.1 关于 XML 文件 写 入 的 

| 1 .ER 336 
11.5.2 ”Google 地 图 XML 的 写 入 
11.5.3 在 XML 指定 位 置 写 入 .. 
司 风 339 


第 12 章 集成 第 三 方 Web 服务 …………341 


12.1 


12. 


b 


123 


实现 后 台 登 录 时 的 验证 码 …………… 


ca 视频 教学 : 11 分 钟 …………. 
12.1.1 实例 描述 .… 
12.1.2 ”实例 应 用 .… 
12.1.3 ”运行 结果 .… 
12.1.4 实例 分 析 … ee 
手机 号 码 归 属地 查询 ………………………. 345 
ca 视频 教学 : 5 分 钟 
2i 


12.2.2 ”实例 应 用 .… .346 
12.2.3 运行 结果 347 
12.2.4 ”实例 分 析 … .347 


忆 地 址 查询 ………………… 


外 
ED 视频 教学 :5 分 钟 
12.3.1 “实例 描述 …………… 


12. 


2 


12. 


2 


13.2 ”创建 第 一 个 WCF 服务 程序 .……………- 


2 


6 


- 


12.3.2 ”实例 应 用 . 
12.3.3 运行 结果 . 
12.3.4 ”实例 分 析 . 
邮政 编码 查询 


ca 视频 教学 : 7 分 钟 ………………… 
12.4.1 实例 描述 . 
12.4.2 ”实例 应 用 . 
12.4.3 运行 结果 . 
12.4.4 实例 分 析 . 
火车 车 次 查询 
-2 视频 教学 : 5 分 钟 .. 
12.5.1 实例 描述 . 
12.5.2 ”实例 应 用 . 
12.5.3 运行 结果 . 
12.5.4 ”实例 分 析 . 


349 


sd 视频 教学 : 7 分 钟 .. 
12.6.1 实例 描述 
12.6.2 ”实例 应 用 . 
12.6.3 ”运行 结果 . 
12.6.4 ”实例 分 析 . 
常见 问题 解答 
12.7.1 ASP.NET Web 服务 和 
ASP.NET 网 站 的 区 别 .. 
12.7.2 ASPNET Web 服务 应 用 程序 


第 13 章 WCF 快速 入 门 .oc 363 
E31 364 
.9 
视频 教学 : 17 分 钟 
13.1.1 基础 知识 一 一 WCF 概述 .…..….364 
13.1.2 ”基础 知识 一 一 WCF 组 成 


es 


9 
Es， 视频 教学 : 16 分 钟 ….…….367 


< 


13. 


13. 


13. 


131 


4 


13.8 “习题 … 


4 


hn 


a 


- 


实例 应 用 . 
运行 结果 . 
13.2.4 ”实例 分 析 
WCF 核心 概念 详解 
rc 视频 教学 : 27 分 钟 …… 
13.3.1 ”基础 知识 一 一 地 址 
13.3.2 ”基础 知识 一 一 绑 定 
13.3.3 ”基础 知识 一 一 合约 
配置 WCF 端点 …………… 
-a 视频 教学 : 5 分 钟 … 
创建 WCF 服务 主机 i 
= 视频 教学 : 2 分 钟 …………………….……. 386 
实现 除法 运算 的 WCEF 服务 . 
= 视频 教学 : 8 分 钟 
13.6.1 实例 描述 . 
13.6.2 ”实例 应 用 . 
13.6.3 运行 结果 . 
13.6.4 ”实例 分 析 . 
常见 问题 解答 .… .391 
13.7.1 WCF 中 的 合约 和 哪 种 技术 
:4 > 
菜鸟 请 教 一 个 WCF 问题 .. 
WCF 使 用 时 的 问题 .. 


13.7.2 
13.73 


第 14 章 网 络 聊天 工具 395 


14. 


14. 


m1) >> 


1 


b 


系统 需求 和 应 用 程序 设计 
14.1.1 系统 需求 
14.1.2 ”应 用 程序 设计 
服务 器 端 设 计 
14.2.1 创建 项 目 结构 
添加 数据 访问 类 .… 
验证 用 户 是 否 存在 
用 户 注册 功能 


14.2.2 
14.2.3 
14.2.4 


14. 


» 


14.4 


14.5 上 


第 15 章 


三 25- 期 户 合 示 贡 能 二 5 
添加 好 友 功能 … 
处 理 好 友 请 求 … 
发 送 消息 功能 … 
14.2.9 发送 文件 功能 … 
14.2.10 ”监听 信息 功能 


14.2.11 获取 好 友 列 表 功 能 


14.2.6 
14.2.7 
14.2.8 


14.3.1 注册 窗 体 功能 设计 
14.3.2 ”登录 窗 体 功能 设计 
14.3.3 ”添加 好 友 窗 体 功能 设 让 
14.3.4 ”聊天 窗 体 功 能 设计 
运行 结果 


15.2 
15.3 


15.4 


15.5 


15.1.1 
15.1.2 ”结构 介绍 … 
15.1.3 自 定义 类 .… 
数据 库 设 计 
服务 器 端 设 计 .. 
1531 
15.3.2 
15.3.3 
15.3.4 
15.3.5 ”管理 留言 功能 
客户 端 设 计 
15.4.1 添加 留言 … 
15.4.2 管理 员 登 录 
15.4.3 ”显示 和 管理 留言 
15.4.4 ”回复 留言 …………… 
运行 效果 . 


ms 人 > 


第 1 章 ， Web 服务 入 门 知 误 


内 容 摘 要 : 

互联 网 经 过 多 年 的 发 展 ， 已 经 日 渐 普及 。 一 提 到 网 络 ， 人 们 就 会 想到 Web，Web 确实 为 
互联 网 的 发 展 做 出 了 巨大 的 贡献 。 能 创造 如 此 辉 煌 成 就 的 Web， 得 益 于 它 天 生 的 两 大 独特 优 
势 : 简单 性 和 方便 性 。 作 为 Web 应 用 的 重要 组 成 部 分 ，Web 服务 也 同样 继承 了 这 两 个 优势 。 

在 没有 使 用 Web 服务 的 应 用 程序 中 ， 不 同 的 系统 之 间 进 行 交互 是 非常 困难 的 ， 甚 至 是 不 
可 能 的 事情 。Web 服务 定义 了 一 套 统一 的 标准 ， 使 用 可 扩展 的 标记 语言 XML 进行 数据 通信 。 
所 以 我 们 使 用 Web 服务 就 可 以 忽略 在 应 用 程序 中 各 系统 之 间 的 通信 差异 ， 真 正 实现 跨 平台 、 
跨 网 络 、 跨 系统 、 跨 语言 的 应 用 程序 通信 功能 。 

Web 服务 的 应 用 范围 广 、 使 用 方便 ， 所 以 有 人 说 它 的 出 现 颠 履 了 传统 的 网 络 应 用 程序 通信 
机 制 ， 预 示 着 一 种 新 的 应 用 程序 架构 的 革命 。 

Web 服务 是 一 种 自 包含 、 自 描述 、 模 块 化 的 应 用 程序 ， 它 可 以 通过 Web 来 发 布 、 定 位 和 
调用 。Web 服务 的 功能 可 以 是 一 个 很 简单 的 请 求 ， 也 可 以 是 一 个 非常 复杂 的 商业 应 用 。 不 过 一 
旦 Web 服务 在 Internet 上 发 布 以 后 , 在 Internet 上 运行 的 其 他 应 用 程序 就 可 以 定位 并 且 使 用 它 。 

本 章 我 们 将 介绍 什么 是 Web 服务 、Web 服务 的 优势 、Web 服务 的 技术 结构 ， 以 及 Web 服 
务 在 NET 平 台中 的 简单 用 法 。 

学 习 目 标 : 

@@ 了 解 什么 是 Web 服务 
了 解 Web 服务 的 优势 
了 解 Web 服务 的 技术 结构 
简单 了 解 .NET 平台 中 的 Web 服务 的 使 用 方法 
简单 了 解 NET 平台 中 的 Web 服务 的 创建 方法 


1.1 访问 网 络 中 的 Web 服务 


Web 服务 是 Internet 中 发 布 的 一 种 数据 信息 交互 服务 ， 我 们 可 以 在 世界 上 有 Internet 服务 
的 任何 地 方 访问 Internet 中 发 布 的 Web 服务。 

Web 服务 是 一 种 自 包 含 、 自 描述 、 模 块 化 的 应 用 程序 ， 所 以 可 以 直接 访问 互联 网 中 的 Web 
服务 ， 查 看 它 的 描述 和 介绍 等 。 

在 本 节 中 ， 我 们 就 简单 来 了 解 一 下 什么 是 Web 服务 ， 以 及 互联 网 中 的 Web 服务 。 


cc 视频 教学 : 光盘 /videos/01/ 访 问 网 络 中 的 Web 服务 .avi @@ 长 度 : 13 分 钟 
网 络 发 展 到 今天 ， 很 少 有 哪个 互联 网 名 词 会 像 *Web 服务 ”一 样 这 么 快 流行 起 来 并 引起 广 
泛 关 注 的 。 


确实 ，Web 服务 的 出 现 ， 可 能 会 是 一 场 软件 行业 的 革命 。 不 过 ，Web 服务 到 底 是 什么 呢 ? 
1. Web 服务 的 概念 


Web 服务 (Web Service) 在 本 书 中 并 不 是 指 Web 中 的 搜索 引擎 、 网 上 交易 、 资 源 下 载 之 类 
的 服务 。 

本 书 中 Web 服务 是 指 在 网 络 中 发 布 的 一 些 应 用 程序 接口 ， 可 以 供 网 络 中 其 他 的 应 用 程序 
访问 。 使 用 这 些 Web 服务 可 以 很 轻松 地 构建 出 功能 更 加 强大 的 应 用 程序 ， 这 些 程 序 功 能 都 由 
Web 服务 来 提供 。 

Web 服务 的 出 现 预 示 着 一 种 新 的 应 用 程序 架构 的 出 现 。 在 可 以 预见 的 未 来 , 互联 网 中 的 应 
用 将 以 Web 服务 的 形式 来 体现 ， 开 发 应 用 程序 的 工作 将 转向 使 用 Web 服务 组 建 应 用 程序 来 完 
成 。 

从 软件 开发 的 角度 来 讲 ，Web 服务 是 Web 服务 器 提供 的 一 个 应 用 程序 ， 或 者 执行 代码 的 
程序 块 。 它 通过 标准 的 XML 协议 来 展示 它 的 功能 。 

2. Web 服务 的 作用 


| 有 些 人 会 觉得 ，Web 服务 与 应 用 服务 提供 商 (如 搜索 引擎 、 网 上 银行 、 网 上 购物 ) 提 供 的 网 
络 服务 相同 。 这 个 观点 不 完全 对 ，Web 服务 确实 是 网 络 中 一 些 运 营 商 提供 的 一 些 基 于 Web 的 
服务 。 但 是 其 只 是 以 一 种 接口 的 形式 展示 的 一 种 应 用 ,站 在 程序 开发 人 员 的 角度 来 讲 ，Web 服 
务 是 为 程序 开发 人 员 提 供 的 一 种 调用 接口 ， 并 不 能 被 最 终 用 户 直接 使 用 。 

那么 ， 肯 定 还 会 有 人 提出 疑问 : Web 服务 到 底 可 以 在 什么 地 方 使 用 呢 ? 

换个 角度 来 思考 ， 有 时 候 同一 个 功能 在 很 多 系统 中 都 会 用 到 ， 而 我 们 不 可 能 为 每 一 个 系统 
都 实现 这 种 功能 。 

最 典型 的 例子 如 提供 天 气 预 报 功能 的 Web 服务 。 很 多 应 用 程序 为 了 提高 实用 性 和 人 性 化 
程度 ， 会 在 程序 中 加 入 天 气 提醒 或 延伸 的 其 他 功能 。 但 是 ， 我 们 不 可 能 要 求 这 些 应 用 程序 的 所 
有 者 都 自己 建立 一 个 气象 台 , 所 以 我 们 就 可 以 使 用 网 络 中 专门 进行 气象 预测 功能 的 运营 商 提供 
的 Web 服务 来 实现 相应 的 功能 ， 如 图 1-1 所 示 。 
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基 
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1-1 Web 服务 示意 图 


当然 ， 在 网 络 中 提供 这 些 服务 的 提供 商 不 是 总 善 机 构 ， 可 能 会 收取 一 定 的 费用 来 
为 Web 服务 者 提供 相应 的 支持 。 


换 句 话 来 说 ，Web 服务 只 是 一 种 共享 编程 的 方法 ， 我 们 可 以 把 它 看 作 “ 应 用 于 Web 中 的 
COM(Component Object Model， 组 件 对 象 模型 )”， 只 不 过 它们 的 实现 技术 有 些 差别 。 

当然 ， 我 们 除了 使 用 互联 网 中 Web 服务 提供 商 提供 的 Web 服务 外 ， 还 可 以 自己 开发 并 发 
布 一 些 Web 服务 供 互联 网 中 的 用 户 使 用 ， 也 可 以 作为 一 种 低 耦 合 的 程序 设计 方案 来 进行 处 理 。 

有 一 些 常用 的 Web 服务 的 使 用 场合 。 


企业 对 企业 之 间 的 内 部 数据 交互 系统 。 这 可 能 是 当前 使 用 Web 服务 最 常见 的 场合 。 
Web 服务 允许 文档 和 知识 共享 ， 或 者 相关 的 服务 的 集成 。 比 如 Web 服务 可 以 帮助 电 
子 商务 公司 与 货运 公司 的 系统 相关 联 ， 实 现 自动 填写 货运 申请 提交 到 货运 公司 的 系 
统 中 。 

作为 开发 人 员 的 预 创建 模块 。 比 如 ， 第 三 方 的 Web 服务 提供 商 可 以 创建 用 于 认证 的 
Web 服务 ， 供 其 他 应 用 程序 使 用 。 

作为 分 布 式 应 用 程序 的 交互 接口 。 比 如 我 们 开发 了 一 个 分 布 式 的 网 络 应 用 系统 ， 在 系 
统 的 各 个 部 分 与 服务 器 之 间 进 行 数据 交互 ， 选 择 Web 服务 的 方式 将 是 非常 简便 的 一 
种 方式 。 

作为 跨 平台 应 用 程序 的 核心 组 件 。 比 如 我 们 开发 了 一 个 可 以 运行 于 包括 台式 机 、 掌 上 
电脑 、 手 机 等 上 的 网 络 程序 ， 使 用 Web 服务 将 会 是 一 种 不 错 的 解决 方案 。 你 不 必 担 
心 不 同 平台 中 程序 的 数据 包 兼 容 性 问题 ， 而 只 确保 每 一 种 用 户 都 能 连 入 Internet 就 可 
以 了 。 

作为 同一 家 企业 中 的 不 同系 统 之 间 的 连接 工具 来 使 用 。 比 如 我 们 可 以 使 用 Web 服务 
将 一 个 企业 销售 管理 系统 和 人 力 资 源 管理 系统 (HR) 相 关联 。 


或 许 通 过 这 些 讲解 你 已 经 对 Web 服务 有 一 些 认识 了 ， 或 许 你 也 有 把 Web 服务 组 织 到 自己 
现 有 的 系统 中 的 想法 了 。 

不 过 要 深刻 地 理解 Web 服务 ， 还 需要 牢记 这 个 非常 重要 的 概念 : Web 服务 不 是 最 终 的 用 
户 产 品 , 而 是 类 似 于 组 件 的 应 用 程序 , Web 服务 允许 在 不 同 环境 和 不 同 的 客户 端 重用 业务 逻辑 。 

Web 服务 的 使 用 者 永远 是 另 一 个 应 用 程序 。 
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3. 实例 描述 

Web 服务 是 网 络 中 的 一 些 公 开 程序 接口 ， 也 就 是 说 可 以 在 Ptemet 的 任意 地 方 访问 它们 。 
本 实例 ， 我 们 将 在 网 络 中 查找 一 个 Web 服务 ， 来 简单 了 解 这 个 Web 服务 的 用 法 。 

4. 实例 应 用 


【 例 1-1】 访问 网 络 中 的 Web 服务 
(1) 首先 ， 要 到 Internet 上 寻找 一 个 提供 Web 服务 的 网 站 。 这 里 我 们 使 用 一 家 国内 Web 
服务 网 站 (网 址 :http://www.webxml.com.cn) 提 供 的 一 些 免费 的 Web 服务， 如 图 1-2 所 示 。 
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1-2 Web 服务 页 面 
(2) 页 面 中 有 一 个 中 英文 双向 翻译 功能 的 Web 服务 (网 址 : http://fy.webxml.com.cn/ 
webservices/EnglishChinese.asmx)， 我 们 可 以 用 它 来 实现 中 英文 翻译 的 功能 。 访问 该 Web 服务 ， 
结果 如 图 1-3 所 示 。 


OO 
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<WebXml ” EnglishChinese 
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从 图 1-3 中 可 以 看 到 ， 该 页 面 以 列表 的 形式 展示 了 该 Web 服务 下 所 有 可 用 的 操作 。 
(3) 接 下 来 单 击 执行 中 英文 双向 翻译 功能 的 Translator 链接 ， 打 开 功 能 的 调用 页 面 ， 如 
图 1-4 所 示 。 


<Webxml 六 ”Englishchinese 
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1-4 中 英文 双向 翻译 


从 图 1-4 中 可 以 看 到 ， 系 统 列 出 了 该 操作 的 简单 说 明 、 测 试 接口 、 一 些 请 求 和 响应 的 示例 
(因为 浏览 器 大 小 的 原因 ， 截 图 中 没有 全 部 显示 )。 

(4) 可 以 在 wordKey 文本 框 中 输入 要 翻译 的 单词 “Hello”， 并 单 击 【调用 】 按 钮 ， 系 统 
将 返回 一 段 包含 响应 结果 的 XML 文本 ， 如 图 1-5 所 示 。 


从" 加 - 己 机 ”7 上 口 于 吕 ”IRO- 克 -“| 


‘scata="urn:schemas. microsoft-com:xml- msdata smins:difor="urn:schemas 
fgram-v "> 


<Wordxey >hello </ Wordxey> 
"buc/Pron> 


sonint (网 画 打扫 昱 或 打 电话 用 湛 ) 只 ,只 罗 </ Translation ~ 
.mp3 Mp3> 


do to he 


said hello to her, but she ignored 
:入 问 名 打扫 时 ,可 弛 要 本 不 理 往 1</ 


1-5 ”翻译 请 求 响应 结果 


从 图 1-5 中 可 以 看 到 ， 这 段 XML 文本 中 包含 了 我 们 想 要 的 翻译 结果 ， 包 括 该 单词 的 音标 、 
中 文章 思 以 及 一 些 简单 的 应 用 示例 。 
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因为 任何 编程 语言 都 可 以 处 理 XML 格式 的 文本 ， 所 以 只 要 能 够 获取 这 段 XML 文本 ， 我 
们 就 可 以 在 任何 一 种 语言 或 平台 中 解析 并 使 用 它 。 


5. 实例 分 析 


总 wa 


本 实例 ， 我 们 首先 在 Internet 中 搜索 找到 一 个 提供 在 线 翻译 功能 的 Web 服务 的 Web 服务 
器 。 然 后 找到 在 线 翻译 功能 的 Web 服务 链接 地 址 ， 并 访问 该 地 址 ， 选 择 执行 在 线 翻译 功能 的 
Translator 操作 , 打开 Web 服务 测试 页 面 ,在 该 页 面 我 们 可 以 看 到 该 Web 服务 操作 的 使 用 说 明 。 
我 们 只 需要 在 wordKey 文本 框 中 输入 要 查询 的 单词 并 单 击 【 调 用 】 按 钮 就 可 以 获得 以 XML 格 
式 显 示 的 翻译 结果 。 


1.2 在 .NET 中 使 用 Web 服务 


从 上 一 节 的 实例 中 ， 我 们 简单 地 了 解 了 Web 服务 。 不 过 既然 前 面 着 重 强调 “Web 服务 的 
使 用 者 永远 是 另 一 个 应 用 程序 ”这 一 根本 思想 ， 所 以 作为 一 名 开发 人 员 ， 你 一 定 会 迫切 地 想 知 
道 在 Web 应 用 程序 中 如 何 使 用 这 些 Web 服务 。 

本 节 ， 我 们 就 在 .NET 语言 中 调用 网 络 中 提供 的 一 个 Web 服务 ， 来 简单 了 解 .NET 语言 中 
的 Web 服务 的 用 法 。 


A 
:视频 教学 :光盘 /videos/01/ 在 .NET 里 使 用 Web 服务 .avi 人 @@ 长 度 : 9 分 钟 


1.2.1 实例 描述 


在 前 面 提 到 的 提供 Web 服务 的 网 站 http://www.webxml.com.cn 中 的 Web 服务 列表 页 面 还 
有 一 个 查询 QQ 在 线 状态 的 Web 服务 ， 它 也 是 一 个 免费 的 功能 。 
本 实例 ， 我 们 就 以 查询 QQ 在 线 状态 为 例 演示 .NET 中 的 Web 服务 的 用 法 。 


1.2.2 ”实例 应 用 


【 例 1-2】 在 .NET 里 使 用 Web 服务 
(1) 首先 ， 找 到 一 个 提供 QQ 在 线 状态 查询 的 Web 服务 ， 网 址 为 http://webservice. 
webxml.com.cn/webservices/qqOnline WebService.asmx。 
(2) 在 浏览 器 中 输入 这 个 网 址 来 测试 Web 服务 ， 如 图 1-6 所 示 。 
从 图 1-6 所 示 的 页 面 可 以 知道 , 该 Web 服务 只 提供 了 一 个 名 为 qqCheckOnline 的 操作 ， 并 
且 该 操作 接收 一 个 QQ 号 码 作为 参数 并 返回 相应 的 状态 码 (或 错误 码 )。 
(3) 单 击 qqCheckOnline 链接 先 来 测试 一 下 这 个 操作 ， 如 图 1-7 所 示 。 
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图 1-7 qqCheckOnline 操作 测试 
(4) 在 qqCode 文本 框 中 输入 一 个 QQ 号 码 ， 然 后 单 击 【调用 】 按 钮 ， 系 统 将 返回 请 求 到 
的 状态 信息 ， 如 图 1-8 所 示 。 
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图 1-8 获取 QQ 在 线 状态 


至 此 ， 说 明 这 个 查询 QQ 在 线 状态 的 Web 服务 是 可 用 的 ， 下 面 我 们 使 用 一 个 控制 台 应 用 
程序 演示 .NET 中 该 Web 服务 的 用 法 。 

(5) 打开 Visual Studio 2010 创建 一 个 控制 台 应 用 程序 ， 命 名 为 QQOnline。 

(6) 鼠标 右键 单 击 项 目 名 称 QQOnline， 在 弹出 的 快捷 菜单 中 选择 【添加 服务 引用 】 命 令 ， 
打开 【添加 服务 引用 】 对 话 框 ， 如 图 1-9 所 示 。 
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图 1-9 【添加 服务 引用 】 对 话 框 


(7) 在 [添加 服务 引用 ] 对 话 框 的 [地址 ] 下 拉 列 表 框 中 输入 Web 服务 的 地 址 “http://webservice. 
webxml.com.cn/webservices/qqOnlineWebService.asmx”， 然 后 单 击 【前 往 】 按 钮 。 稍 等 片刻 就 
会 链接 成 功 ， 在 【服务 】 列 表 框 中 就 会 列 出 相应 的 请 求 结果 ， 如 图 1-10 所 示 。 

》 在 单 击 【 前 往 〗】 按 钮 以 后 ， 如 果 网 速 正 常 ， 几 秒 或 几 十 秒 就 可 以 获得 响应 ， 如 果 
曙 示 | 。 网 速 较 慢 ， 可 能 会 需要 较 长 的 时 间 。 


亚 加 服务 引用 


a habbit i 


hservice oan inoh | [BE] | (WR [| 


Cae jCan |] 


1-10 ”添加 服务 引用 


(8) 修改 【命名 空间 】 文 本 框 中 的 值 为 QQOnlineQuery， 然 后 单 击 【 确 定 】 按 钮 。 这 样 就 
成 功 地 添加 了 查询 QQ 是 否 在 线 Web 服务 的 引用 。 


5 在 使 用 Visual Studio 2010 添加 对 Internet 中 Web 服务 的 引用 时 ， 系 统 可 能 会 在 应 
注意 | 。 用 程序 配置 文件 (web config 或 app.config) 中 生成 一 些 重复 的 配置 节点 ， 这 时 就 需 
要 我 们 手动 出 除 多 余 的 配置 节点 。 


(9) 接 下 来 修改 控制 台 Program 类 中 的 代码 ， 如 下 所 示 : 


class Program 

' 
static void Main(string[] args) 
{ 


@- 一 


QQoon1lineQuery-dqqon1lineWwebServiceSoapClient onlineQuery = 
new QQOonlineQuery.qqonlineWebServiceSoapClient (); 


Console.Write ("请 输入 您 要 查询 的 QQ 号 码 : ") ; 
String inputQQ = Console.ReadLine(); 
string status = onlineQuery.qqCheckOnline (inputQQ); 
PrintStatus (status); 
console.ReadLine () ; // 程 序 暂 停 ， 等 待 用 户 回 车 确认 
static void PrintStatus (string status) 
{ 
switch (status) 
{ 

二 
Console.WriteLine ("在 线 "); 
break; 

case "N": 

Console.WriteLine ("离线 "); 
break; 

Case "E": 

Console.WriteLine ("QQ 号 码 错误 ") ; 
break; 

Case "A": 
Console.WriteLine ("商业 用 户 验证 失败 ") ; 
break; 

case "V": 
Console.WriteLine ("免费 用 户 超过 数量 ") ; 


break; 


这 里 我 们 创建 一 个 查询 QQ 号 码 在 线 状 态 的 实例 对 象 onlineQuery， 然 后 调用 该 对 象 的 
qqCheckOnline() 方 法 查询 用 户 输入 的 QQ 号 码 在 线 状态 ， 并 将 请 求 结果 打印 到 控制 台中 。 


1.2.3 ”运行 结果 


保存 程序 文件 。 单 击 工具 栏 上 的 【启动 调试 】 按 钮 ，”， 程 序 会 提示 输入 一 个 QQ 号 码 ， 执 
行 结果 如 图 1-11 所 示 。 


1-11 查询 QQ 号 码 的 在 线 状态 
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本 


ul， 


1.2.4 ”实例 分 析 


Cn 


本 实例 ， 我 们 首先 获取 查询 QQ 在 线 状态 的 Web 服务 地 址 ， 然 后 在 浏览 器 中 访问 该 地 址 ， 
使 用 一 个 QQ 号 码 进行 测试 。 我 们 需要 在 控制 台 程 序 中 添加 对 该 Web 服务 的 引用 。 当 成 功 添 
加 引用 以 后 ， 就 可 以 使 用 引用 时 输入 的 命名 空间 下 的 qqOnlineWebService SoapClient 类 创建 查 
询 对 象 。 之 后 ， 通 过 调用 该 对 象 下 的 qqCheckOnline() 方 法 完成 相应 的 查询 功能 。 


1.3 ”为 什么 使 用 Web 服务 


前 面 列举 了 Web 服务 的 作用 ， 并 且 通 过 一 些 例 子 进行 了 简单 的 应 用 。 从 这 些 例子 中 我 们 
不 难看 出 ，Web 服务 在 各 个 方面 都 非常 有 用 。 

从 使 用 范围 上 来 讲 ，Web 服务 既 可 以 作为 一 些 应 用 服务 发 布 给 开发 人 员 ; 也 可 以 作为 信息 
发 布 的 接口 ， 供 用 户 调用 。 

而 且 ， 从 使 用 者 的 投资 成 本 和 回报 率 上 来 讲 ，Web 服务 十 分 节约 成 本 ， 使 用 起 来 也 非常 安 
全 方便 。 

下 面 我 们 就 针对 Web 服务 的 各 种 优点 来 进行 详细 介绍 。 


Pp 
加 "视频 教学 : 光盘 /videos/01/ 为 什么 使 用 Web 服务 .avi 全 长 度 : 9 分 钟 


1.3.1 ”基础 知识 一 一 Web 服务 的 优点 


整体 来 说 ，Web 服务 的 优点 非常 多 ， 以 至 于 有 人 认为 “ 它 的 出 现 颠 覆 了 传统 的 网 络 应 用 程 
序 通信 机 制 ”。 


1. Web 服务 是 一 种 优秀 的 分 布 式 计算 技术 


基于 组 件 的 分 布 式 计算 的 应 用 程序 系统 通常 使 用 的 协议 是 CORBA(Common Object 
Request Broker Architecture， 通 用 对 象 请 求 代理 体系 结构 ) 和 Microsoft 的 DCOM(Distributed 
Component Object Model， 分 布 式 组 件 对 象 模型 )。 

对 于 这 两 种 协议 ， 尽 管 它们 有 许多 相通 之 处 , 但 是 它们 在 细节 上 有 很 多 不 同 ， 也 导致 使 用 
这 两 个 协议 的 应 用 程序 很 难 进行 相互 通信 。 假 如 要 实现 一 个 跨 平台 、 跨 Intemet、 适 应 Internet 
的 可 伸缩 性 的 应 用 程序 时 使 用 这 两 种 协议 ， 将 会 显得 力不从心 。 

而 Web 服务 不 同 ， 它 是 基于 组 件 的 分 布 式 技术 变革 的 必然 产物 。 创 建 跨 平台 、 跨 Internet 
的 分 布 式 系 统 ， 正 是 Web 服务 的 优势 所 在 。 

总 体 来 说 ，Web 服务 在 实现 分 布 式 应 用 方面 ， 主 要 有 以 下 几 个 特征 。 


m= >> 
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@ ”Web 服务 与 客户 端的 联系 松散 。 客 户 端 向 Web 服务 发 出 请 求 ，Web 服务 器 向 客户 端 
返回 响应 结果 ， 然 后 连接 就 会 断 开 。 使 用 这 种 方式 不 存在 永久 性 链接 ， 因 而 避免 了 链 
接管 理 等 复杂 性 的 问题 。Web 服务 可 以 随意 扩展 其 接口 , 并 在 添加 新 的 方法 以 后 不 会 
影响 客户 端的 使 用 。 

@ ”Web 服务 与 状态 无 关 。Web 服务 不 支持 代表 客户 端的 状态 信息 ， 这 使 得 它 在 面 对 许 
多 客户 端的 时 候 伸缩 自如 。Web 服务 使 用 的 HITP 协议 也 是 与 状态 无 关 的 。 


2. 可 以 轻松 地 跨 过 防火 墙 


对 于 在 网 络 中 运行 的 各 个 主机 来 说 ， 引 入 防火 墙 是 非常 有 必要 的 事情 ， 防 火 墙 可 以 阻止 入 
侵 者 进入 网 络 ， 消 除 局 域 网 中 不 友好 的 网 络 通信 。 特 别 是 对 于 服务 器 来 说 ， 使 用 防火 墙 是 很 有 
必要 的 事情 。 

但 是 ， 每 一 种 事物 的 出 现 都 有 利 有 次。 防火 墙 可 以 很 好 地 保护 网 络 中 主机 的 安全 ， 但 是 这 
种 安全 保护 却 要 付出 一 些 代 价 : 它 使 得 合理 的 网 络 通信 也 出 现 一 定 的 瓶颈 。 合 理 、 正 确 地 配置 
防火 墙 来 支持 DCOM 通信 是 一 件 非常 不 容易 的 事情 , 所 以 使 用 DCOM 等 协议 来 实现 一 个 网 络 
通信 系统 非常 不 方便 。 

而 SOAP 协议 从 设计 的 角度 就 直接 避免 了 这 个 问题 ， 它 直接 标准 化 了 对 象 请 求 时 的 HTTP 
使 用 方法 。 


@@， SOAP 使 用 HTTP 作为 其 通信 协议 ，HTTP 协议 可 以 很 轻松 地 通过 防火 墙 ， 所 以 
提示 SOAP 就 轻松 地 避免 了 这 个 问题 。 


3. 使 用 的 SOAP 协议 非常 简单 


虽然 DCOM 使 用 起 来 也 具有 一 定 的 优势 ， 比 如 其 具有 位 置 透明 性 等 ， 程 序 中 不 需要 包括 
任何 特殊 的 DCOM 代码 等 。 但 是 建立 一 个 DCOM 系统 并 使 之 正常 运行 并 不 是 一 件 容易 的 事情 
(如 何 通过 防火 墙 就 是 一 个 问题 )。 

DCOM 服务 器 必须 在 客户 端 上 进行 注册 , 当 服 务 器 被 修改 以 后 , 客户 端的 代码 必须 随 之 更 
新 ， 所 以 基于 其 开发 的 应 用 程序 使 用 起 来 非常 不 易 。 

使 用 Web 服务 就 大 不 一 样 了 。Web 服务 使 用 的 是 SOAP 协议 ， 它 比较 灵活 ， 要 求 的 技术 
含量 也 非常 低 。SOAP 可 以 利用 通用 的 XML 分 析 器 和 当前 流行 的 HTTP 服务 器 来 实现 。 

而 且 Web 服务 的 串 行 化 格式 基于 XML 语言 。XML 简单 、 可 扩展 、 易 读 ， 已 经 得 到 广泛 
的 支持 和 应 用 。 相 对 于 具有 复杂 格式 的 DCOM 和 CORBA 来 说 ，Web 服务 在 对 传输 的 数据 进 
行 处 理 的 问题 上 非常 优秀 。 


4. 集中 信息 


有 人 说 Web 服务 的 出 现 是 “一 种 新 的 应 用 程序 架构 的 革命 ”， 很 大 程度 上 也 体现 在 这 
个 方面 。 

Web 可 能 真 的 会 改变 当前 的 应 用 程序 的 架构 。 以 前 面 举 过 的 天 气 预报 的 例子 为 样本 ， 我 
们 直接 使 用 Web 服务 提供 商 提供 的 天 气 预报 服务 ， 别 人 也 可 以 直接 使 用 这 种 服务 。 那 么 ， 当 
有 一 天 , 所 有 的 人 都 在 使 用 这 一 家 Web 服务 提供 商 的 天 气 预报 功能 的 Web 服务 时 , 全 世界 的 
天 和 气 预报 信息 都 将 集中 在 这 一 家 信息 中 心 的 服务 器 中 ， 就 达到 了 天 气 预报 信息 的 集中 化 。 


< 


当然 ， 互 联网 中 的 其 他 服务 也 可 以 实现 真正 的 集中 ， 比 如 个 人 信息 。 现 在 的 情况 是 每 一 个 
互联 网 系统 都 有 一 套用 户 信息 系统 ， 这 样 用 户 信息 非常 分 散 ， 用 户 在 某 一 个 系统 中 注册 的 用 户 
信息 不 能 在 另 一 个 系统 中 使 用 ， 使 用 多 个 系统 的 用 户 通常 在 修改 一 项 个 人 信息 时 ， 需 要 重复 修 
改 多 个 系统 中 的 相应 信息 。 

再 考虑 另 一 种 情况 ， 很 多 时 候 我 们 会 将 自己 的 通信 记录 保存 在 不 同 的 地 方 : 有 的 保存 在 笔 
记 本 电脑 中 ， 有 的 保存 在 手机 中 。 这 些 不 同 地 方 保存 的 信息 往往 不 会 同步 ， 而 且 格 式 可 能 也 不 
相同 。 

而 使 用 Web 服务 ， 数 据 的 集中 处 理 将 变 得 非常 容易 。 我 们 可 以 在 一 个 集中 的 信息 登记 处 
来 注册 个 人 信息 ， 然 后 便 可 以 在 多 个 系统 (地 方 ) 同 步 使 用 、 更 新 和 维护 一 份 相同 的 信息 。 

”当然 这 样 会 面临 数据 覆盖 的 风险 ， 但 是 我 们 可 以 使 用 历史 记录 等 工具 来 记录 每 一 
由 去 | 。 次 修改 ， 以 备 不 测 。 

这 个 思想 ， 虽 然 非常 有 创意 ， 但 是 现实 的 情况 并 不 能 很 好 地 适应 当前 的 社会 环境 。 不 过 庆 
幸 的 是 有 一 些 互 联网 服务 提供 商 已 经 开始 着 手 做 此 类 的 一 些 服 务 了 ， 最 典型 的 当 属 Microsoft 
的 Passport 了 。 

Passport 服务 是 一 种 单项 签名 验证 的 服务 ， 当 前 它 已 经 有 很 多 用 户 了 ， 当 然 主要 应 用 在 流 
行 的 Hotmail 和 MSN 服务 等 系统 中 。 

当然 ， 随 着 时 代 的 发 展 ， 这 种 使 用 Web 服务 的 数据 集中 的 形式 肯定 会 慢 慢 地 被 用 户 所 接 
受 。 这 些 互 联网 服务 提供 商 的 大 力 推广 和 大 胆 应 用 肯定 会 促进 这 一 过 程 的 发 展 。 期 待 那 一 刻 ! 


1.3.2 ”实例 描述 


刚才 我 们 简单 介绍 了 在 实现 应 用 程序 功能 的 时 候 使 用 Web 服务 的 诸多 优点 ， 或 许 我 们 对 
这 些 优 点 还 没有 一 个 很 完整 的 概念 。 
下 面 以 使 用 一 个 火车 时 刻 表 的 Web 服务 为 例 ， 简 单 介绍 一 下 使 用 Web 服务 的 优点 。 


1.3.3 ”实例 应 用 


【 例 1-3】 为 什么 使 用 Web 服务 

(D 首先 ， 我 们 需要 找到 提供 火车 时 刻 表 查询 功能 Web 服务 的 地 址 ， 这 里 以 
http://webservice.webxml.com.cn/ WebServices/TrainTimeWebService.asmx 为 例 。 

其 实 ， 就 从 这 个 简单 的 Web 服务 地 址 ， 我 们 就 可 以 知道 : Web 服务 是 一 个 兼容 性 很 好 的 
网 络 通 信 方 式 。 

该 Web 服务 地 址 其 实 就 是 一 个 Web 服务 器 上 的 资源 地 址 。 当 然 ， 这 里 使 用 的 是 Web 服 
务 器 处 理 的 请 求 ， 使 用 的 程序 端口 为 Web 服务 器 的 端口 ， 协 议 为 Web 服务 器 所 使 用 的 HTTP 
协议 。 

Web 服务 对 于 网 络 中 的 服务 器 来 说 ， 应 该 是 必 开 的 一 个 服务 了 吧 ， 不 论 是 Windows 平台 
还 是 Linux 平台 ， 或 者 是 其 他 平台 。 所 以 ， 它 也 就 没有 了 使 用 平台 的 兼容 性 的 问题 了 。 


mf) >> 
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(2) 我 们 使 用 浏览 器 访问 这 个 Web 服务 的 地 址 ， 结 果 如 图 1-12 所 示 。 


actaiotanaadnmcaurratmcadc 
大 车 交 春光 大 车 对 利 丰 String() 
和 区 代 于 和 市， 宇和 以 上 开化 训 D2 深 ,uneriD | 
Selo) 和 Smt] -入 m3) 二 二， hi et me 


ES ET 
1-12 ”火车 时 刻 表 查 询 


(3) 我 们 选择 通过 发 车 站 和 到 达 站 查询 火车 时 刻 表 的 链接 getStationAndTimeByStation 
Name， 打 开 该 方法 的 测试 和 说 明 页 面 。 

该 页 面 中 有 此 方法 的 使 用 说 明和 操作 接口 。 使 用 SOAP 请 求 和 响应 的 数据 格式 说 明 如 
图 1-13 所 示 。 


全 ee ra 有 CR TE IIRQ- 已 -“ 


从 图 1-13 中 的 SOAP 协议 请 求 和 响应 的 数据 信息 来 看 , Web 服务 使 用 XML 来 格式 化 数据 。 
因为 XML 语言 使 用 统一 的 标准 ， 而 且 使 用 起 来 非常 简单 , 所 以 基于 SOAP 的 Web 服务 也 非常 
简单 易 用 。 

(4) 我 们 使 用 该 页 面 提供 的 查询 接口 进行 简单 的 测试 。 在 StartStation 文本 框 中 输入 发 车 
站 “郑州 ”， 在 ArriveStation 文本 框 中 输出 到 达 站 “深圳 ”， 然 后 单 击 【调用 】 按 钮 ， 将 自动 
在 新 窗口 打开 返回 的 查询 结果 ， 如 图 1-14 所 示 。 


< 人 mm 


las-microsofr-comcxmi-msdato' xmns:difmr=rarn:schemas- 


‘sdata:roworder="0" diffar:haschanges—"Inserted"> 


asroworder=T diffgr :hasChanges="inserted"> 


图 1-14 查询 结果 


从 图 1-14 中 可 以 看 到 ， 返 回 结果 是 以 XML 格式 保存 的 。 因 此 ， 在 任何 一 个 平台 上 ,在任 
何 一 种 编程 语言 中 ， 我 们 都 可 以 很 轻松 地 对 请 求 得 到 的 XML 文件 进行 解析 。 

另外 ， 使 用 Web 服务 对 火车 时 刻 表 查 询 的 功能 进行 了 封装 、 发 布 ， 使 我 们 在 Internet 的 任 
一 地 方 都 可 以 很 方便 地 使 用 它 ， 轻 松 地 实现 了 数据 信息 服务 的 集中 。 


1.3.4 ”实例 分 析 


ns 


本 实例 , 我 们 首先 获取 查询 火车 时 刻 表 信息 的 Web 服务 地 址 , 从 服务 地 址 中 可 以 知道 Web 
服务 是 基于 使 用 HTTP 协议 的 Web 应 用 。 这 样 就 轻松 地 避免 了 服务 器 安全 性 管理 的 问题 。 接 
着 在 浏览 器 中 访问 该 地 址 ， 从 页 面 中 对 Web 服务 方法 的 说 明 可 以 知道 Web 服务 使 用 SOAP 协 
议 进行 数据 封装 和 传输 ， 这 样 又 解决 了 数据 信息 的 跨 平 台 性 和 通用 性 。 从 测试 接口 中 ， 我 们 很 
方便 地 查询 到 了 想 要 的 数据 ， 并 不 需要 我 们 进行 复杂 的 操作 ， 这 也 正体 现 了 Web 服务 的 信息 
集中 的 特点 。 


1.4 ”Web 服务 的 技术 架构 


前 面 我 们 简单 地 对 Web 服务 进行 了 介绍 ， 或 许 我 们 已 经 对 它 有 一 定 的 认识 了 。 但 是 ， 对 
它 使 用 的 技术 、 它 的 运行 机 制 等 问题 ， 在 我 们 脑海 中 并 没有 一 个 完整 的 概念 。 

本 节 ， 我 们 就 来 对 Web 服务 所 涵盖 的 技术 进行 逐一 分 析 ， 对 Web 服务 进行 一 个 更 加 全 面 
的 了 解 。 
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< 视频 教学 : 光盘 /videos/01/ 进 一 步 了 解 Web 服务 .avi 国 攻 度 : 8 分钟 


其 实 对 于 Web 服务 来 说 ， 它 虽然 是 一 种 使 用 Web 提供 服务 的 技术 ， 但 其 并 不 是 独立 的 一 
种 技术 ， 而 是 多 种 不 同 技术 的 综合 运用 。 

前 面 我 们 已 经 简单 地 使 用 .NET 访问 过 Web 服务 。 在 NET 中， 使 用 Web 服务 就 像 访问 一 
个 本 地 的 类 一 样 方便 。 那 么 ， 在 这 整个 过 程 中 Web 服务 是 如 何 封 装 资源 、 如 何 描 述 、 如 何 发 
现 、 如 何 访问 资源 的 呢 ? 

在 不 同类 型 的 系统 、 不 同 的 平台 间 实 现 互 操作 性 ， 必 须要 有 一 套 信息 传输 标准 。 对 于 Web 
服务 来 说 ， 同 样 也 有 一 套 这 样 的 标准 。 这 套 标 准 中 包含 这 样 一 些 技术 : XML、SOAP、WSDL、 
UDDI、 远 程 过 程 调用 (RPC) 与 消息 传递 等 。Web 服务 应 用 程序 使 用 这 些 技术 执行 客户 端 与 服务 
器 端的 交互 。 具 体 执行 过 程 如 图 1-15 所 示 。 


查询 Web 服 务 


Web 服 务 器 


检索 WSDL 文 档 


Web 服 务 方法 
Web 服 务 方法 
调用 Web 服 务 方 Web 服 务 方法 


并 检索 查询 结果 


图 1-15 Web 服务 的 交互 过 程 
1. XML 和 XSD 


XML(Extensible Markup Language， 可 扩展 标记 语言 ) 是 万 维 网 协会 (World Wide Web 
Consortium，W3C) 于 1998 年 推荐 使 用 的 语言 。 经 过 这 么 多 年 的 发 展 ，XML 已 经 被 广泛 地 接受 
为 用 于 不 同 计算 机 系统 的 互 操作 性 解决 方案 。 

尽管 XML 也 存在 一 些 不 足 ， 但 是 由 于 它 良好 的 性 能 已 经 被 广 为 接 受 ， 所 以 它 现在 是 我 们 
追求 的 处 理 软 件 互 操作 性 的 最 佳 解决 方案 。 

XML 是 Web 服务 中 表示 和 封装 数据 的 基本 格式 。 除 了 其 容易 建立 和 容易 分 析 之 外 ，XML 
主要 还 有 与 平台 无 关 、 与 厂商 无 关 的 特点 。 

Web 服务 的 平台 是 使 用 XSD 来 作为 数据 类 型 系统 的 。 当 用 某 一 种 语言 构造 一 个 Web 服务 
时 ， 为 了 符合 Web 服务 的 标准 ， 所 有 使 用 的 数据 类 型 必须 被 转换 为 一 个 XSD 类 型 。 

另外 ， 如 果 转 换 为 XSD 类 型 的 数据 需要 在 不 同 的 平台 和 不 同 软件 之 间 传 递 时 ， 还 需要 使 
用 某 种 东西 将 它们 封装 起 来 。 这 种 封装 它们 的 东西 就 是 SOAP 协议 。 


< 人 mm 


2. SOAP 


SOAP(Simple Object Access Protocol, 简单 对 象 访问 协议 ) 是 为 Web 服务 所 选择 的 消息 传递 
协议 。 
Web 服务 使 用 XML 格式 的 消息 与 客户 通信 ， 而 SOAP 协议 标准 的 核心 思想 是 应 该 使 用 一 
种 标准 化 的 XML 格式 对 消息 进行 编码 。 
SOAP 可 以 运行 在 任何 传输 协议 上 ， 如 超 文本 传输 协议 (Hyper Text Transfer Protocol， 
HTTP)、 简 单 邮件 传输 协议 (Simple Mail Transfer Protocol，SMTP) 等 。 
Web 服务 希望 实现 不 同 的 系统 之 间 能 够 用 软件 对 软件 的 方式 进行 对 话 , 其 打破 了 传统 的 软 
件 应 用 、 网 站 和 各 种 不 同 设备 间 互 不 相 容 的 状态 ， 实 现 了 基于 Web 的 “无 颖 集成 ”的 目的 。 
下 面 的 代码 展示 了 一 个 人 P 地 址 查询 的 Web 服务 的 SOAP 请 求 数据 包 的 格式 。 该 数据 包 中 
的 有 效 数 据 部 分 包括 在 名 为 soap:Envelope 的 XML 节点 中 ， 如 下 所 示 : 
<?xml] version="1.0" encoding="utf-8"?> 
<soap:Envelope xmlns:Xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0org/2001/XMLSchema" 
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> 
<soap:Body> 
<GetGeoIP xmlns="http://www.webservicex.net/"> 
<IPAddress>string</IPAddress> 
</GetGeoIP> 
</soap:Body> 
</soap:Envelope> 
上 面 这 段 代码 足以 证 明 SOAP 的 简洁 性 和 通用 性 。 所 以 我 们 没有 理由 在 Web 服务 中 不 使 
用 SOAP 数据 格式 。 
SOAP 的 优点 很 多 ， 其 中 包括 以 下 最 为 重要 的 三 点 。 
@ 路 平台 支持 : SOAP 是 一 段 文本 代码 , 所 以 可 以 很 轻松 地 在 各 种 不 同 的 平台 下 使 用 它 ， 
当然 也 可 以 在 任何 一 种 传输 协议 中 发 送 SOAP 内 容 。 
@ 支持 标题 和 扩展 名 : 使 用 SOAP 数据 时 ， 还 可 以 使 用 工具 很 轻松 地 添加 追踪 、 加 密 和 
安全 性 等 特性 。 
@ ”灵活 的 数据 类 型 : SOAP 允许 在 XML 中 对 数据 结构 和 DataSet 编码 , 就 像 是 编程 语言 
中 的 简单 数据 类 型 (如 数值 型 和 字符 型 ) 一 样 。 
3. WSDL 


WSDL(Web Services Description Language，Web 服务 描述 语言 ) 是 使 用 计算 机 能 阅读 的 方 
式 提供 的 一 个 正式 的 描述 文档 的 语言 。WSDL 基于 XML 语言 ， 用 于 描述 Web 服务 以 及 Web 
服务 的 函数 、 方 法 的 参数 和 方法 的 返回 值 等 信息 。 

WSDL 使 用 XML 列举 了 某 个 Web 服务 的 所 有 方法 、 所 有 参数 以 及 方法 的 返回 值 。 正 因为 
其 使 用 的 是 XML， 所 以 可 以 被 计算 机 阅读 ， 又 可 以 被 人 阅读 。 

4. UDDI 


UDDI(Universal Description, Discovery and Integration， 通 用 描述 、 发 现 与 集成 服务 ) 是 一 种 
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目录 服务 。 企 业 使 用 它 可 以 对 Web 服务 进行 注册 和 搜索 。 

UDDI 是 一 套 基于 Web 的 、 分 布 式 的 、 专 为 Web 服务 提供 的 、 信 息 注册 中 心 的 实现 标准 
规范 。 同 时 UDDI 也 包含 了 一 组 使 企业 能 将 自身 提供 的 Web 服务 注册 ， 以 使 其 他 企业 能 够 必 
现 和 访问 的 协议 实现 标准 。 

为 了 使 用 Web 服务 ， 客 户 当然 需要 知道 相应 公司 提供 的 Web 站 点 地 址 或 者 发 现 文件 的 
URL。 这 个 发 现 文件 是 非常 有 用 的 ， 它 们 可 以 将 多 个 Web 服务 合并 到 一 个 单独 的 列表 中 。 但 
是 它们 不 允许 客户 在 不 了 解 这 个 公司 的 情况 下 搜索 Web 服务 的 信息 。 

UDDI 提供 了 一 个 数据 库 来 填补 这 个 缺陷 , 企业 可 以 在 这 个 数据 库 中 发 布 自己 的 企业 信息 、 
提供 的 Web 服务 信息 、 第 一 个 服务 的 类 型 ， 以 及 与 这 些 服务 有 关 的 其 他 信息 和 规范 的 链接 。 

不 过 即使 你 在 UDDI 注册 服务 中 找到 了 想 要 的 Web 服务 ， 也 只 是 能 得 到 一 个 方法 定义 的 
集合 ， 文 档 说 明 非常 少 ， 可 以 说 相当 于 一 个 非常 简单 的 API 参考。 

5. 远程 过 程 调用 RPC 

Web 服务 本 身 实现 的 是 应 用 程序 间 的 通信 。 通常 情况 下 , 我 们 在 应 用 程序 之 间 通 信使 用 的 
是 消息 传递 的 方式 。 但 是 前 面 我 们 也 已 经 看 到 了 ， 在 客户 端 使 用 Web 服务 的 时 候 就 像 调用 一 
个 本 地 方法 一 样 简单 (如 图 1-16 所 示 )， 它 是 怎么 实现 的 呢 ? 也 就 是 说 它 如 何 实现 从 消息 传递 到 
远程 过 程 调用 的 方式 呢 ? 图 1-16 所 示 的 是 消息 传递 到 过 程 调用 的 示意 图 。 


客户 机 服务 器 
方法 调用 


1-16 ”消息 传递 到 远程 过 程 调用 


为 了 实现 这 种 简便 的 远程 过 程 调用 的 形式 ，Web 服务 对 这 些 信息 进行 了 简单 的 映射 同样 
还 使 用 消息 传递 的 方式 来 实现 Web 服务 的 远程 调用 。 也 就 是 说 Web 服务 的 远程 过 程 调用 是 靠 
内 部 的 消息 传递 来 完成 的 ， 如 图 1-17 所 示 。 
消息 
类 : Counter 
方法 : Add 


参数 : 2, 4 
We web 服务 


服务 器 


接收 响应 


1-17 ”执行 远程 过 程 调用 


< 


远程 过 程 调 用 是 一 种 协议 ， 全 称 为 Remote Procedure Call Protocol， 简 称 RPC。 使 用 RPC 
的 时 候 ， 客 户 端的 运行 方式 是 调用 服务 器 上 的 远程 过 程 。 
@ ”这 里 的 “过 程 ”相当 于 .NET 中 的 方法 。 在 早 些 时 候 的 编程 语言 中 ， 没 有 “方法 ” 
未 | ”这 个 概念 ， 其 至 还 没有 “函数 ”这 个 概念 ， 所 以 称 之 为 “过 程 ”。 
调用 服务 器 上 的 远程 过 程 ， 在 .NET 中 实现 的 通常 方式 是 实例 化 一 个 远程 对 象 并 调用 其 方 
远程 过 程 调用 RPC 倾向 于 使 Web 服务 的 位 置 透明 化 。 服 务 器 可 提供 远程 对 象 的 接口 ， 客 
户 端 使 用 服务 器 中 的 远程 方法 就 像 在 本 地 使 用 的 这 些 Web 服务 对 象 的 接口 一 样 ， 这 样 就 隐藏 
了 Web 服务 的 底层 实现 信息 ， 客 户 端 也 不 需要 知道 对 象 具体 指向 的 是 哪 台 主机 。 


1.5 使 用 ASP.NET 构建 一 个 Web 服务 


前 面 我 们 已 经 全 面 地 了 解 了 Web 服务 的 原理 ， 并 且 已 经 在 .NET 中 使 用 控制 台 程序 实现 了 
对 Web 服务 的 访问 。 当 然 ， ASP.NET 作为 一 个 优秀 的 开发 技术 ， 其 中 也 提供 了 对 Web 服务 的 
开发 支持 ; 不仅 如 此 ， 使 用 ASPNET 开发 Web 服务 程序 是 一 件 非常 容易 的 事情 。 下 面 我 们 通 
过 一 个 简单 的 实例 ， 来 演示 一 下 ASPNET 中 的 Web 服务 。 


人 视频 教学 : 光盘 /videos/01/ 构 建 一 个 Web 服务 .avi 人 @@ 长 度 : 6 分 名 


1.5.1 实例 描述 


在 ASPNET 中 ， 使 用 集成 开发 环境 Visual Studio 创建 一 个 Web 服务 的 过 程 非常 简单 。 我 
们 不 需要 做 任何 配置 ， 只 需要 根据 需求 编写 相应 的 业务 逻辑 代码 即 可 。 

本 实例 ,我 们 就 来 使 用 Visual Studio 在 ASP.NET 应 用 程序 中 创建 一 个 执行 加 法 计算 的 Web 
服务 。 


1.5.2 ”实例 应 用 


【 例 1-4】 使 用 ASP.NET 构建 一 个 Web 服务 

(1) 首先 需要 创建 一 个 “ASP.NET Web 应 用 程序 ”项 目 。 

(2) 在 该 项 目的 根 目录 下 创建 一 个 “Web 服务 ”项 目 ， 命 名 为 Counter.asmx。 创 建成 功 以 
后 系统 会 自动 生成 模板 代码 ， 其 中 包含 一 个 示例 方法 ， 代 码 如 下 : 

using System; 

using System.Collections.Generic; 

using System.Linqg; 


using System.Web; 
using System.Web.Services; 
namespace WebService 
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/// <summary> 
/// counter 的 摘要 说 明 
/// </summary> 
[WebService (Namespace = "http://tempuri.org/")] 
[WebServiceBinding (ConformsTo = WsiProfiles.BasicProfilel 1)] 
[System.ComponentMode]l .ToolboxItem (false)] 
// 若 要 人 允许 使 用 ASP.NET AJAX 从 脚本 中 调用 此 web 服务 ， 请 取消 对 下 行 的 注释 。 
// [System.Web.Script.Services.ScriptService] 
public class Counter : System.Web.Services.WebService 
{ 

[WebMethod] 

public string HelloWorld() 

{ 

return "Hello World"; 


} 


} 


(3) 这 里 我 们 需要 执行 加 法 运算 ， 所 以 我 们 来 修改 生成 的 Web 方法 HelloWorld， 修 改 为 
具有 两 个 参数 的 Add 方法 ， 具 体 代码 如 下 : 
public class Counter : System.Web.Services.WebService 
. [WebMethod] 
public decimal RAdd (decimal nl, decimal n2) 
: return nl + n2; 
} 
} 
至 此 ， 我 们 的 Web 服务 就 算 创 建成 功 了 。 
(4) 接 下 来 ， 使 用 一 个 访问 Web 项 目的 客户 端 程序 。 这 里 我 们 还 使 用 一 个 控制 台 程序 来 
访问 这 个 Web 服务 。 
(5) 为 了 使 大 家 更 容易 理解 ， 我 们 重新 创建 一 个 项 目 ， 用 来 调用 该 Web 服务 。 这 里 我 们 
创建 一 个 控制 台 项 目 。 
(6) 在 新 创建 的 控制 台 项 目 中 添加 一 个 服务 引用 ， 引 用 地 址 为 刚才 创建 的 Web 服务 的 地 
址 (这 里 是 http://localhost:7735/Counter.asmx)， 并 且 在 “命名 空间 ”文本 框 中 设置 新 创建 的 Web 
服务 的 命名 空间 为 ServiceCounter。 
(7) 修改 控制 台 项 目 中 自动 生成 的 Program 类 ， 添 加 使 用 Web 服务 执行 加 法 操作 的 代码 ， 
如 下 所 示 : 
class Program 


{ 


static void Main(string[] args) 
{ 
ServiceCounter.CounterSoapClient counter = 
new ServiceCounter.CounterSoapClient (); 


Console.Write ("请 输入 加 数 : ") ; 


< 


@,. 服务 开发 学 习 实录 


decimal valuel = decimal.Parse (Console.ReadLine ()); 
Console.Write ("请 输入 被 加 数 : ") ; 

decimal value2 = decimal.Parse (Console.ReadLine()); 
Var result = counter.Add (valuel, value?2); 
Console.WriteLine (result); 


Console.ReadLine () ; // 程 序 暂停 ， 等 待 用 户 回 车 确认 


} 
如 此 ， 整 个 实例 就 算 完成 了 ， 下 面 我 们 来 测试 一 下 。 


1.5.3 ”运行 结果 
首先 ， 需 要 运行 Web 项 目 。 


接 下 来 访问 创建 的 Web 服务 的 地 址 http:/localhost:773S/Counter.asmx, 访问 结果 如 图 1-18 
所 示 。 


Counter 
FT 人 .有 类 下 区 丸 ， 汪 最 务 检 明 。 


二 Web 服务 全 用 http://tempuri.org/ 作 访 次 认 全 实则 。 
建 汉 : 公开 XML Web services 之 曾 ， 请 更 下 对 认 克 才 空间 


51 和 宇和 庆生 人 LA 
于 开关 有 的 XML Web services 而 已 的 XML Web servicss 应 保有 更 力 水 人 


图 1-18 Web 服务 Counter 


可 以 看 到 ， 其 界面 和 前 面 测试 的 其 他 Intemet 上 发 布 的 Web 服务 一 模 一 样 。 这 里 我 们 单 击 
Add 超 链 接 对 该 操作 进行 访问 ， 结 果 如 图 1-19 所 示 。 


fleeceat 


全 由 让 天 。 基 comte Nek 服务 前" 则 -了 琐 ED 5 四 - IRW- 和 司 - 


Counter 
芋 二 能 处 ， 苞 联 友 下 的 痪 作弄 表 - 


Add 
3 
i 扶 租 _ 


全 


EE 


sonp L1 
TF SDA 1.2 证 订 直 全 所 性 示 节 占 信箱 大 娄 为 卫 全. 
POST /Cosacer,aaax ETTP/1.L 
ac， lccalacas 


Cearerz-Typey texs/mml; charsecrcst-6 
Caneenz-Iernazhz lenath 


1-19 Web 服务 Counter 中 的 Add 操作 
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Add 操作 的 测试 页 面 ， 下 面 同样 有 测试 模块 和 一 些 简单 的 说 明 。 在 测试 模块 的 nl 文 
本 框 中 输入 23.5， 在 n2 文本 框 中 输入 56， 然 后 单 击 【 调 用 】 按 钮 ， 系 统 会 请 求 Web 服务 器 


并 返回 执行 结果 ， 如 图 1-20 所 示 。 


(Ehttp://localhostsT135/Counter. asax/Add — Windows Int 


司 ecatheat 


帝 收 头 习 | 大 http:AnecahestTT 


<zxml version="1.0" ancoding="utf-8" ?> 
<decimal xmlns "http:/ /tempuri.org/">79.5</decimal> 


图 1-20 执行 结果 


然后 再 来 测试 控制 台 访 问 Web 服务 的 结果 。 运 行 控制 台 程 序 ， 根 据 提示 输入 相应 的 数字 ， 
稍 等 即 可 输出 响应 结果 ， 如 图 1-21 所 示 。 


File:///E:/Thh/Webservices/ explain/ Unitl/Testyobservice/bin/Devoe/ 10 = 居 昌 四 | 


图 1-21 控制 台 程 序 执行 结果 


1.5.4 ”实例 分 析 


sw 


本 实例 ， 首 先 创建 一 个 ASPNET Web 应 用 程序 ， 在 该 Web 应 用 程序 中 创建 一 个 Web 服 
务 ; 然后 系统 会 自动 生成 代码 文件 ， 其 中 包含 一 个 简单 的 Web 服务 方法 ; 接着 将 这 个 Web 服 
务 方法 修改 为 一 个 执行 加 法 操作 的 方法 ; 最 后 创建 一 个 控制 台 程序 引用 新 创建 的 Web 服务 ， 
并 接收 用 户 输入 的 数值 ， 调 用 远程 的 方法 执行 加 法 操作 ， 并 打印 出 执行 结果 。 


1.6 常见 问题 解答 


1.6.1 什么 是 Web Service 


Ey 什么 是 Web Service? 
区 网 络 课堂 : http:Wbbs.itzcn.comythread-14984-1-1.html 


今天 听 到 有 人 在 说 Web Service, Web Service 是 什么 呢 ? 直接 从 字面 上 理解 , 是 Web 服务 ， 
但 是 Web 服务 又 是 什么 呢 ? 


< 


【解决 办 法 】 

Web Service 是 一 种 新 的 Web 应 用 程序 分 支 ， 它 们 是 自 包含 、 自 描述 、 模 块 化 的 应 用 ， 可 
以 发 布 、 定 位 并 通过 Web 调用 。 

Web Service 可 以 执行 从 简单 的 请 求 到 复杂 商务 处 理 的 任何 功能 。 一 旦 部 署 以 后 , 其 他 Web 
Service 应 用 程序 可 以 发 现 并 调用 它 部 署 的 服务 。 

Web Service 是 一 种 应 用 程序 ， 它 可 以 使 用 标准 的 互联 网 协议 ， 像 超 文本 传输 协议 (HTTP) 
和 XML， 将 功能 纲领 性 地 体现 在 互联 网 和 企业 内 部 网 上 。 可 将 Web 服务 视 作 Web 上 的 组 件 
编程 。 


1.6.2 Web Service 和 Web Server 的 区 别 


Web Service 和 Web Server 的 区 别 。 
网 络 课堂 : http://bbs.itzen.com/thread-14985-1-1.html 


今天 听 到 有 人 在 讲 Web Service， 我 记得 以 前 上 学 的 时 候 学 到 过 一 个 Web Server 的 概念 。 
它们 有 什么 区 别 呢 ? 

【解决 办 法 】 

概念 上 根本 就 是 两 个 东西 。 像 TS、Apache 这 类 的 软件 都 叫做 Web Server， 可 以 让 用 户 通 
过 用 焉 访问 服务 器 的 下 看 到 一 个 页 面 , 或 者 完成 从 页 面 上 传递 来 的 数据 交互 。 而 Web Service 
仅仅 是 一 个 API。 

比如 要 想 创建 一 个 Web Service, 它 的 作用 是 返回 当前 的 天 气 情况 , 那么 可 以 建立 一 个 Web 
页 面 ， 用 于 接受 邮政 编码 作为 查询 字符 串 ， 然 后 返回 一 个 由 逗号 隔 开 的 字符 串 ， 包 含 当前 的 气 
温和 和 天气， 要 调用 这 个 Web 页 面 ， 并 向 它 传 入 参数 ， 就 可 以 返回 这 样 格 式 的 一 行 数据 : “21, 
晴 ”。 那么 这 个 Web 页 面 就 应 该 可 以 算 作 是 一 个 Web Service 了 。 因为 它 基于 HTTP GET 请 求 ， 
提供 了 一 个 可 以 通过 Web 调用 的 API。 

当然 ， 真 正 的 Web Service 肯定 不 是 这 么 实现 的 ， 不 过 内 部 原理 都 一 样 。 


1:7” 习 题 

一 、 填 空 题 

(1) Web 服务 是 指 在 网 络 中 发 布 的 一 些 ， 可 以 供 网 络 中 其 他 的 应 用 程序 访问 。 

(2) 是 为 Web 服务 所 选择 的 消息 传递 协议 。 

(3) WSDL 基于 ， 用 于 描述 Web 服务 、Web 服务 的 函数 、 方 法 的 参数 和 方法 
的 返回 值 等 信息 。 

二 、 选 择 题 

(1) 下 面 不 是 使 用 Web 服务 的 优点 。 


A. Web 服务 是 一 种 优秀 的 分 布 式 计算 技术 


(2) 


G) 


由 
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B. Web 服务 可 以 轻松 地 跨 过 防火 墙 
C.，Web 服务 使 用 的 SOAP 协议 非常 简单 
D. Web 服务 使 数据 更 加 分 散 ， 保 证 了 数据 的 安全 性 


下 面 选项 中 ， 不 是 Web 服务 用 到 的 技术 。 
A. XML B. SOAP C. WSDL D. SMTP 
下 面 所 有 使 用 Web 服务 的 环境 ， 使 用 得 非常 不 恰当 。 


A. 银行 提供 的 网 上 支付 接口 

B.， 货运 公司 提供 的 查询 运单 信息 的 功能 
C. 企业 网 站 的 产品 管理 功能 

D. 企业 HR 系统 中 的 员工 信息 功能 


上 机 练习 


上 机 练习 1: 使 用 Web 访问 Internet 中 提供 的 免费 天 气 预报 功能 。 

在 本 章 中 我 们 已 经 对 Web 服务 进行 了 比较 深入 的 介绍 .也 使 用 网 络 中 提供 的 一 些 商业 Web 
服务 进行 了 一 些 简单 演示 。 

本 练习 ， 我 们 就 在 Internet 中 找 一 个 提供 免费 天 气 预报 功能 的 Web 服务， 然后 在 浏览 器 
查询 当前 最 新 的 天 气 预 报信 息 ， 如 图 1-22 所 示 。 


货 收 卉 天 | 大 Ntp:J1rw vebservi 移 - 加 富 邮 ”中 安全 G IO ， 导 - 


<pxml version="1,0" encodi ei "utf-g" ?> 
String xmlns ="http;/ /www.webserviceX.NET" ><?xml version- 
16 人 2 <CurrentWeather> rare China cc) 
34-43N 113-39E 111M</Location> <Time>Feb i {a a S 
2011.02.25 0900 UTC</Time> <Wind> from the ) at 
KD recton Variable) 0 /Wind> evaibiity> A miley evinity> 
:onditions> <Temperature> 41 F (5 C) 


52%</RelativeHumidity> <Pressure> 30.24 in. Hg (1024 hpa)</Pressure> 
<Status>Success</Status> </CurrentWeather> </strng> 


图 1-22 中国 郑州 的 天 气 预 报 查询 结果 


< 
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内 容 摘要 : 


通过 第 1 章 的 学 习 ， 我 们 了 解 了 Web 服务 的 相关 技术 和 架构 ， 还 对 Web 服务 的 使 用 有 了 
简单 认识 。 

我 们 知道 ，Web 服务 实际 上 是 一 种 结构 、 一 种 组 织 应 用 软件 的 模式 。 它 并 没有 基于 任何 一 
种 开发 工具 、 语 言 甚至 运行 平台 。 但 是 ， 作 为 Web 服务 的 开发 者 ， 必 须 选 择 一 种 自己 熟悉 的 、 
效率 高 的 开发 工具 和 编程 语言 进行 开发 。 

在 这 方面 ，ASP.NET 无 疑 是 最 佳 选择 。 它 采用 的 .NET Framework 框架 可 以 很 容易 地 创建 
和 运行 一 个 Web 服务 ， 而 且 借助 于 Visual Studio 开发 工具 的 支持 能 够 大 大 减少 开发 人 员 的 
王 作 。 

在 本 章 中 ， 我 们 将 学 习 创 建 Web 服务 的 各 种 方法 ， 并 重点 对 使 用 Visual Studio 创建 
ASP.NET Web 服务 和 修改 Web 服务 的 属性 进行 介绍 。 

学 习 目标 : 

@ 掌握 如 何 用 记事 本 创建 Web 服务 
了 解 Web 服务 处 理 指令 的 用 法 
掌握 Web 服务 类 和 方法 的 使 用 
掌握 wsdl 和 csc 命令 的 使 用 
掌握 Visual Studio 创建 和 测试 Web 服务 的 方法 
了 解 添加 服务 引用 与 Web 引用 的 区 别 
熟悉 创建 Web 服务 时 的 WebService 属性 
了 解 如 何 使 用 WebMethod 属性 控制 Web 服务 方法 


2.1 使 用 记事 本 创建 Web 服务 


虽然 Visual Studio 为 .NET 开发 提供 了 功能 丰富 的 集成 开发 环境 ， 但 是 这 并 不 是 创建 Web 
服务 的 唯一 途径 。 使 用 一 种 文本 编辑 器 (例如 记事 本 ) 和 .NET Framework 包含 的 命令 行 工具 ， 也 
可 以 创建 Web 服务 。 


a 视频 教学 : 光盘 /videos/02/ 记 事 本 创建 Web 服务 .avi 人 @ 长 度 : 13 分 钟 


2.1.1 ”基础 知识 一 一 WebService 处 理 指令 


由 于 使 用 记事 本 编写 的 程序 都 为 纯 文本 内 容 ， 为 了 使 其 能 够 被 正确 识别 为 Web 服务 ， 首 
先 需 要 以 .asmx 为 扩展 名 进行 保存 。 

此 外 ， 为 了 将 文件 中 的 类 和 方法 被 编译 器 标识 为 Web 服务 ， 还 需要 一 个 特殊 的 ASP.NET 
处 理 指令 一 一 WebService。 该 处 理 指令 必须 写 在 文件 的 第 一 行 ， 用 于 表明 实现 Web 服务 的 类 ， 
以 及 使 用 的 编程 语言 等 属性 。 

WebService 处 理 指令 的 使 用 示例 如 下 : 


<%@ WebService Language="C#" Class="TestWebService " %> 


要 想 使 Web 服务 正常 工作 ，WebService 处 理 指令 的 Language 和 Class 属性 都 必须 设置 。 
其 中 , 设置 Language 属性 可 以 告诉 .NET Framework 该 Web 服务 中 的 类 是 使 用 哪 一 种 程序 设计 
语言 编写 的 ， 设 置 Class 属性 是 为 了 告诉 ASP.NET 将 要 作为 Web 服务 表述 的 类 的 名 称 。 

在 这 个 例子 中 ，WebService 处 理 指令 指定 Web 服务 的 类 为 TestWebService， 使 用 的 编写 
语言 为 C#。 这 实际 上 将 通知 .NET Framework 需要 使 用 C# 编 译 器 把 类 TestWebService 编译 成 一 
个 具有 Web 输出 方法 的 Web 服务 。 


$ WebService 处 理 指令 还 有 一 个 Codebehind 属性 是 可 选 的 ， 用 来 指定 当前 Web 服 
| 务 所 用 的 后 台 代码 文件 。 


2.1.2 ”基础 知识 一 一 声明 Web 服务 类 和 方法 


声明 Web 服务 类 与 声明 其 他 普通 类 没有 任何 区 别 , 例如 在 上 节 声 明 的 TestWebService 类 。 
不 过 ， 如 果 想 要 在 Web 服务 中 访问 ASP.NET 的 内 置 对 象 ， 像 Application、Session 和 Context 
等 ， 则 该 Web 服务 器 必须 继承 自 WebService 类 。 

另外 ， 在 实现 Web 服务 的 类 中 可 能 会 有 很 多 方法 ， 但 并 不 是 所 有 的 方法 都 可 以 通过 Web 
进行 调用 。 而 是 只 有 那些 添加 了 WebMethod 属性 的 方法 才 可 以 调用 ， 而 且 必 须 声 明 为 public。 

通常 ， 我 们 也 将 在 Web 服务 类 中 带 有 WebMethod 属性 ， 且 为 public 类 型 的 方法 简称 为 
Web 服务 方法 。 

例如 ， 下 面 的 示例 代码 创建 了 一 个 Web 服务 类 TestWebService， 并 提供 了 一 个 名 为 Hello 


mf >> 
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的 Web 服务 方法 。 


using System.Web.Services; 
public class TestWebService:WebServices 


§ 
[WebMethod] 
public string Hello() 
{ 
return “Hello"s 


' 
} 


2.1.3 ”实例 描述 


Visual Studio 对 Web 服务 提供 了 强大 的 支持 ， 强 大 到 我 们 都 不 知道 它 干 了 些 什 么 。 

没关系 ， 本 节 我 们 先 不 用 工具 ， 而 用 记事 本 创建 一 个 简单 的 Web 服务 。 从 本 质 上 了 解 一 
下 Web 服务 的 组 成 及 创建 方法 。 

别 小 看 这 节 啊 。 只 有 吃 尽 过 去 的 苦 ， 才 明白 现在 的 幸福 。 同 样 你 只 有 深刻 地 体会 了 不 用 
Visual Studio 的 痛苦 ， 才 能 知道 使 用 Visual Studio 的 幸福 。 


2.1.4 实例 应 用 


【 例 2-1】 使 用 记事 本 创建 Web 服务 
(1) 打开 Windows 系统 自 带 的 记事 本 程序 ， 添 加 如 下 的 代码 : 


<%@ WebService Language="C#" Class="myFirstWebService" %> 
using System.Web.Services; 
public class myFirstWebService : WebService 
{ 

[WebMethod] 

public string HelloWorld() 

{ 

return "Hello World!"; 

} 

[WebMethod] 

public string Hello(string name) 


{ 
return "欢迎 ”+ name + "的 访问 ， 当 前 时 间 为 : " + System.DateTime .Now; 


} 
} 
(2) 将 代码 保存 到 一 个 文件 中 。 注 意 ， 保 存 的 时 候 应 该 以 .asmx 为 扩展 名 。 例 如 ， 在 这 里 
我 们 将 文件 保存 为 myFirstWebService.asmx。 
(3) 这 样 一 个 Web 服务 就 创建 好 了 。 为 了 使 其 能 够 通过 浏览 器 访问 , 我 们 在 IS 上 新 建 一 
个 虚拟 目录 firstService， 它 指向 本 地 磁盘 的 物理 路 径 (F:\myfirst)。 


< 


(4) 将 Web 服务 文件 myFirstWebService.asmx 复制 到 新 建 的 firstService 目录 下 ， 完 成 
实例 。 


2.1.5 “运行 结果 


现在 ， 我 们 需要 在 IS 下 运行 新 建 的 Web 服务 。 很 简单 ， 就 像 运 行 ASP.NET 页 面 一 样 ， 
在 浏览 器 中 输入 Web 服务 的 URL 来 打开 myFirstWebService.asmx 文件 就 行 了 。 

在 本 实例 中 ， 我 们 输入 “http://localhost/firstService/myFirstWebService.asmx” 之 后 ，Web 
服务 的 浏览 页 面 如 图 2-1 所 示 。 


图 2-1 浏览 Web 服务 


”如 果 读 者 是 先 安 装 NET， 再 安装 IS， 浏 览 .asmx 文件 时 可 能 会 弹出 “访问 IS 元 

提示 | 数据 库 失败 ”的 错误 。 解决 办 法 是 ， 在 命令 提示 符 下 进入 .NET Framework 的 安装 

目录 ， 例 如 “C:\\WWINDOWS\Microsoft.NET\Framework\v2.0.50727”， 再 运行 
“aspnet_regiis.exe -i” 命令 修复 IIS 即 可 。 


如 图 2-1 所 示 ， 可 以 看 到 页 面 开 始 显 示 的 是 Web 服务 名 称 ， 再 往 下 是 Web 服务 中 可 调用 
的 方法 : Hello 和 HelloWorld， 再 往 下 的 内 容 是 如 何 为 Web 服务 器 定义 命名 空间 等 信息 。 

单 击 其 中 一 个 方法 的 链接 , 则 会 出 现 一 个 用 于 测试 该 方法 的 测试 页 面 。 如 果 该 方法 有 参数 ， 
那 该 测试 页 面 将 会 有 用 于 输入 Web 测试 参数 的 文本 输入 框 。 

例如 ， 单 击 Hello 链接 ， 进 入 的 调用 页 面 如 图 2-2 所 示 。 


rr 


Hello 


mt 
i HTF FasT 过 公 人 和 ， 这 和 二 “天 下” 近 浊 ， 


2-2 调用 Hello 方法 
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在 这 里 为 name 参数 指定 一 个 值 ， 再 单 击 【 调 用 】 按 钮 测试 该 Web 服务 方法 ， 结 果 将 以 
XML 形式 显示 ， 如 图 2-3 所 示 。 


图 2-3 调用 Hello 方法 的 显示 结果 
如 果 出 现 了 XML 文档 格式 的 页 面 ， 那 么 恭喜 你 ，Web 服务 创建 成 功 了 。 


2.1.6 ”实例 分 析 


ee 


在 该 实例 中 ， 我 们 用 记事 本 编写 Web 服务 ， 从 最 简单 的 实例 中 了 解 Web 服务 的 组 成 和 创 
建 方法 。 需 要 注意 的 是 ， 在 保存 的 时 候 需 要 将 记事 本 保存 为 .asmx 格式 的 文件 ， 因 为 .asmx 文件 
是 Web 服务 的 入 口 。 并 且 需 要 将 文件 保存 到 IIS 虚拟 目录 对 应 在 本 地 磁盘 的 物理 路 径 下 。 

如 果 需 要 将 方法 添加 到 Web 服务 里 ， 需 要 向 该 方法 添加 WebMethod 属性 。 


2.2 ”从 命令 行 执行 Web 服务 


使 用 Web 服务 的 过 程 实际 上 就 是 将 Web 服务 的 使 用 者 与 Web 服务 实现 绑 定 , 然后 再 调用 
其 中 的 方法 。 对 于 绑 定 最 简单 、 最 常用 的 方法 就 是 创建 一 个 Web 服务 的 WSDL。 本 节 ， 我 们 
仍然 从 命令 行 形式 进行 讲解 如 何 绑 定 、 编 译 和 执行 一 个 Web 服务 。 


9 
国 ， 视频 教学 : 光盘 /videos/02/ 命 令 行 执行 Web 服务 avi 人 @@ 长 度 : 6 分 名 


2.2.1 基础 知识 一 一 创建 代理 类 


.NET 客户 端 用 户 应 用 程序 可 以 通过 一 个 代理 与 Web 服务 进行 通信 。 这 个 代理 是 从 Web 
服务 WSDL 文档 创建 的 一 个 .NET 程序 集 。 既 可 以 由 Visual Studio 自动 创建 Web 服务 代理 ， 也 
可 以 使 用 由 .NET Framework 提供 的 wsdl.exe 创建 代理 类 源 代 码 ， 然 后 再 使 用 NET Framework 
中 的 csc.exe 编译 器 将 代理 类 编译 为 代理 程序 集 (.dll 文件 )。 

创建 代理 之 后 ，Web 服务 使 用 者 只 需 从 中 调用 Web 方法 ， 代 理 将 会 执行 Web 服务 的 实际 
请 求 ， 在 请 求 中 也 可 以 指定 端点 的 位 置 ， 无 论 是 在 局 域 网 内 还 是 通过 Internet 连接 到 另 一 个 
家 或 洲 都 可 以 。 当 用 户 在 使 用 者 应 用 程序 中 引用 Web 服务 时 ， 它 就 如 同 是 使 用 者 应 用 程序 的 
一 部 分 ， 与 通常 的 内 部 函数 调用 一 样 。 图 2-4 就 演示 了 这 一 过 程 。 


< 


b | 
已， ED 


Oo) 代理 @ . 


2-4 ”代理 使 用 Web 服务 的 过 程 


这 一 过 程 包 含 以 下 几 个 步骤 。 
(1) 应 用 程序 执行 代理 代码 中 的 函数 ， 为 其 传递 合适 的 参数 ， 但 并 不 知道 代理 将 要 调用 


Web 服务 。 
(2) 代理 接收 到 调用 后 ， 格 式 化 将 要 发 送 到 Web 服务 的 请 求 ， 该 Web 服务 是 使 用 者 用 参 
数 指定 的 。 


(3) 函数 调用 从 代理 发 送 到 Web 服务 。 调 用 可 以 发 生 在 同一 台 计 算 机 之 中 ， 也 可 以 通过 
局 域 网 或 者 Internet 进行 调用 。 

(4) Web 服务 使 用 代理 提供 的 参数 执行 其 可 以 通过 Web 调用 的 函数 , 并 把 结果 放 入 XML 
文档 中 。 

(5) 来 自 Web 服务 的 结果 数据 返回 给 使 用 者 处 的 代理 。 

(6) 代理 分 析 来 自 Web 服务 的 XML， 获取 生成 的 各 个 值 。 

(7) 使 用 者 应 用 程序 从 代理 函数 获得 需要 的 值 ， 完 全 不 必 考 虑 它们 来 自 Web 服务 调用 。 

这 种 代理 方法 的 好 处 是 将 .NET 用 户 应 用 程序 与 在 代理 中 处 理 的 分 布 式 调用 过 程 分 隔 开 。 
这 意味 着 如 果 基 本 的 消息 格式 或 者 传输 协议 发 生 了 变化 ， 那 么 只 需要 重新 编译 代理 ， 以 使 用 新 
的 消息 或 者 传输 协议 ， 而 不 必 重 新 编写 使 用 者 应 用 程序 (当然 ， 如 果 基 本 的 通信 语义 发 生 了 重 
大 变化 ， 通 常 需要 重新 编写 应 用 程序 )。 从 使 用 者 应 用 程序 的 角度 看 ， 代 理 只 不 过 是 展示 远程 
服务 接口 的 另 一 个 程序 集 。 当 然 ， 虽 然 代理 使 得 使 用 Web 服务 的 过 程 变 得 更 加 容易 ， 但 是 不 
使 用 代理 也 可 以 使 用 Web 服务 。 


2.2.2 ”基础 知识 一 一 使 用 命令 生成 代理 


在 使 用 命令 生成 代理 前 ， 我 们 要 确保 系统 里 安装 了 必 备 执行 工具 ， 它 们 是 wsdl.exe、 
csc.exe( 如 果 采 用 VB.NET， 可 能 还 需要 vbc.exe)， 并 且 将 它们 的 路 径 添加 到 系统 变量 里 。 

所 以 ， 我 们 要 对 环境 变量 进行 配置 ， 只 有 这 样 ， 才 能 保证 在 任何 目录 下 进行 操作 。 对 于 
Visual Studio 2010 来 说 ， 各 路 径 如 下 : 

csc.exe 位 于 CcC:\WINDOWS\Microsoft.NET\Framework\v4.0.30319 

wsdl.exe 位 于 c:\Program Files\Microsoft SDKs\Windows\v7.0A\bin 

添加 方法 为 : 右 击 【我 的 电脑 】 图 标 ， 在 弹出 的 快捷 菜单 中 选择 【 属性】 命令 ， 在 弹出 的 
对 话 框 中 打开 【高 级 】 选 项 卡 ， 再 单 击 【 环 境 变量 】 按 钮 从 弹出 的 对 话 框 中 双击 Path 变量 ; 
之 后 将 上 面 的 路 径 添 加 到 【变量 值 】 文 本 框 中 即 可 ， 两 个 路 径 之 间 用 分 号 分 隔 ,， 如 图 2-5 所 示 。 


==) >> 
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2-5 ”编辑 环境 变量 


接 下 来 ， 测 试 环 境 变 量 是 否 生效 。 进 入 命令 提示 符 窗口 ， 输 入 WSDL， 将 会 得 到 该 命令 的 
帮助 ， 如 图 2-6 所 示 ， 则 说 明 添加 成 功 。 


项 <uRL 或 路 证 》<RL 


myRL 划 耻 主 》 
指 间 UsDL 协定 ，xsp 架构 毒 .atseenap 文 栏 的 WRL 或 路 主 ， 


loge, 
取消 显示 版 权 标 吉 ， 


language: Clanguage) 
用 于 生成 的 代理 类 的 语言 请 从 “cs "， “ea "， “os "， “aas "、 吉 


图 2-6 测试 WSDL 


wsdl.exe 工具 是 .NET Framework 的 一 部 分 ,只 需 指 定 Web 服务 描述 文档 的 URL, wsdl.exe 
就 会 自动 生成 可 以 编译 为 代理 DLL 的 源 代码 。wsdl.exe 工具 的 命令 行 语法 如 下 : 


wsdl.exe < 参数 > < URL 或 者 路 径 > 


在 表 2-1 中 列 出 了 wsdl.exe 命令 的 常用 参数 及 说 明 ， 第 二 个 参数 为 通过 URL 或 者 路 径 方 
式 指定 一 个 要 生成 代理 的 Web 服务 。 


表 2-1 wsdl.exe 命令 参数 


参 数 说 明 
各: 指定 需要 认证 的 服务 器 的 用 户 名 
/Pp: 需要 认证 的 服务 器 的 密码 选项 
/o: 指定 输出 源 代码 的 文件 名 。 默 认 值 是 根据 Web 服务 的 名 称 生成 的 
hn: 指定 输出 代理 代码 的 命名 空间 
潍 指定 代理 类 源 代码 所 使 用 的 语言 ， 可 选 的 语言 选项 有 CS(C#， 默 认 )、VB 和 JS 
7 指定 代理 类 将 用 于 通信 的 协议 ,代理 类 可 以 在 多 种 协议 如 SOAP( 默 认 )、HttpGet 或 者 HttpPost 
上 和 运行， 也 可 以 指定 Web 服务 支持 的 自 定义 协议 


< 


在 为 Web 服务 创建 代理 类 之 后 ， 还 需要 将 代理 类 源 代码 编译 为 一 个 程序 集 ， 这 可 以 使 用 
csc.exe 编译 器 来 实现 。 表 2-2 中 列 出 了 csc.exe 编译 程序 的 部 分 命令 行 参数 及 其 说 明 。 
表 2-2 csc.exe 命令 参数 


参 数 说 明 
/out:< 文 件 > 指定 输出 文件 的 名 称 和 位 置 ， 默 认 时 ， 编 译 器 从 源 文件 名 得 到 输出 名 称 
ht: 指定 输出 文件 的 类 型 (包括 exe、winexe、library、module 等 类 型 ) 
在 指定 一 个 程序 集 列 表 ， 这 些 程序 集 以 逗号 或 者 分 号 隔 开 ， 它 们 可 以 在 编译 时 使 许 
/doc:< 文 件 > | 指定 要 生成 的 XML 文档 文件 
/checked[+|-] | 是 否 启用 生成 溢出 检查 
/unsafe[+|- 是 否 允许 “ 不 安全 ”代码 
/nologo 取消 编译 器 的 版 权 信息 


指定 以 UTF-8 编码 格式 输出 编译 器 信息 


/utf8output 


2.2.3 ”实例 描述 


无 论 是 否 使 用 Visual Studio 开发 工具 ， 我 们 都 能 够 很 容易 地 开发 Web 服务 。 而 且 在 上 节 
中 ， 我 们 已 经 掌握 了 如 何 用 记事 本 创建 一 个 Web 服务 并 在 IS 上 测试 。 

下 面 我 们 同样 不 需要 借助 工具 ,而 是 要 进入 命令 提示 符 窗口 来 完成 Web 服务 代理 的 创建 ， 
通过 执行 命令 来 编译 ， 并 编写 控制 台 程 序 进行 测试 。 


2.2.4 ”实例 应 用 


【 例 2-2】 命令 行 执行 Web 服务 

(1) 上 节 我 们 创建 了 一 个 myFirstWebService.asmx, 并 放 到 了 IIS 的 firstService 虚拟 目录 下 。 

(2) 进入 命令 提示 符 窗口 , 使 用 wsdl 命令 创建 对 myFirstWebService.asmx 的 代理 。 执 行 命 
令 如 下 : 

wsdl /1:cs /n:aSpace http://localhost/firstService/myFirstWebService.asmx 


(3) 执行 后 ， 我 们 可 以 看 到 如 图 2-7 所 示 的 结果 。 


2-7 ”执行 wsdl 命令 创建 代理 
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根据 提示 ， 可 以 在 C:\Documents and Settings\Administrator 目录 下 看 到 生成 了 一 个 名 为 
myFirstWebService.cs 的 文件 。 

(4) 创建 好 C# 文 件 后 ， 需 要 把 它 编译 成 DLL 文件 ， 方 便 其 他 程序 进行 调用 。 这 就 需要 用 
到 csc 命令 ， 执 行 命令 如 下 : 


csc /out:GreetingsPS.dl1 /t:library /r:system.data.dll /r:system.web.services. 


dll myFirstWebService.cs 


执行 后 的 结果 如 图 2-8 所 示 。 


图 2-8 执行 csc 命令 生成 DLL 文件 


从 结果 中 ,可 以 看 到 生成 了 一 个 名 为 GreetingsPS.dll 的 DLL 文件 。 这 样 ,我们 的 代理 就 创 
建 好 了 ， 如 果 其 他 程序 想 进 行 调用 ， 那 么 只 需要 引用 GreetingsPS.dll 文件 就 可 以 了 。 
(5) 使 用 Visual Studio 创建 一 个 控制 台 应 用 程序 ， 测 试 上 面 的 Web 服务 是 否 正 常 。 
(6) 在 【解决 方案 资源 管理 器 】 窗 格 中 打开 【添加 引用 】 对 话 框 ， 然 后 通过 【浏览 】 选 项 
卡 找 到 ese 生成 的 DLL 程序 集 文件 ， 如 图 2-9 所 示 。 
(7) 切换 到 .NET 选项 卡 ， 找 到 System.Web.Services 并 单 击 ， 如 图 2-10 所 示 。 


送 jn 引 用 


mr co | 项 目 襄 吕 二 十 “com 项 目测 忠生 过 
直 抠 范 国 C) 


六 六 型 gD) 


图 2-9 引用 GreetingsPS .dll 程序 集 图 2-10 引用 System.Web.Services 程序 集 
(8) 单 击 【 确 定 】 按 钮 关闭 对 话 框 ， 此 时 引用 就 完成 了 。 编 写 调用 Web 服务 的 代码 ， 如 


下 所 示 为 最 终 文件 的 实现 代码 : 


using System; 

using System.Collections.Generic; 
using System.Linqg; 

using System.Text; 


using aSpace7 


namespace ConsoleApplicationl 
{ 
class Program 
{ 
static void Main (string[] args) 
{ 
myFirstWebService m = new myFirstWebService(); 
string name = " 王 微微 "; 
Console.WriteLine(); 
Console.WriteLine ("调用 Web 服务 后 返回 的 信息 为 : ”+ m.Hello (name)); 


} 
(9) 保存 对 文件 的 修改 ， 完 成 实例 的 制作 。 


2.2.5 ”运行 结果 


按 下 Ctrl+F5 组 合 键 运行 当前 的 控制 台 项 目 ,将 会 在 命令 提示 符 下 看 到 输出 结果 ,如 图 2-11 
所 示 ， 说 明 调 用 成 功 。 


当前 时 间 为 ，2811-2-25 16:@7:82 


图 2-11 运行 结果 


2.2.6 ”实例 分 析 


区 


在 使 用 命令 生成 代理 中 ， 我 们 首先 要 注意 的 是 在 环境 变量 中 编辑 系统 变量 Path 的 值 ， 将 
wsdl.exe 和 csc.exe 实用 程序 所 在 目录 的 路 径 写 入 系统 变量 Path 的 值 字符 囊 中 。 这 样 ， 在 使 用 
命令 生成 代理 时 ， 用 户 在 命令 行 提 示 下 就 不 用 输入 每 个 文件 的 完整 目录 了 。 

在 引用 的 时 候 ， 我 们 不 光 要 引用 csc 生成 的 DLL 程序 集 文 件 ， 同 时 还 要 引用 
System.Web.Services 程序 集 ， 否 则 程序 无 法 运行 。 


2.3 ”实现 用 户 登 录 验 证 的 Web 服务 


在 前 面 两 节 介绍 了 如 何 使 用 记事 本 和 命令 行 编译 器 来 创建 Web 服务 。 使 用 这 种 方式 在 编 
写 简单 的 例子 时 还 可 以 应 付 ， 当 要 编写 由 很 多 文件 组 成 的 大 型 项 目 时 就 显得 力不从心 了 。 
此 时 , 我 们 便 可 以 利用 Visual Studio 工具 来 创建 Web 服务 。Visual Studio 可 以 将 我 们 从 复 


mS >> 
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杂 的 命令 行 中 解脱 ， 将 主要 精力 集中 到 Web 服务 的 实现 上 。 
oc 视频 教学 : 光盘 /videos/02/ 登 录 验 证 的 Web 服务 .avi Ok 度 : 9 分 钟 


2.3.1 ”基础 知识 一 一 利用 Visual Studio 创建 Web 服务 


和 创建 其 他 类 型 的 应 用 程序 一 样 ，Visual Studio 为 创建 Web 服务 也 提供 了 模板 。 我们 所 要 
做 的 工作 只 是 在 这 个 模板 中 添加 所 需 的 代码 ， 非 常 方 便 。 

本 书 采 用 的 是 Visual Studio 2010， 它 是 一 个 功能 非常 强大 的 集成 开发 环境 ， 而 且 提 供 了 对 
最 新 NET Framework 4 的 支持 。 此 外 ，Visual Studio 2010 还 提供 了 .NET Framework 3.5、.NET 
Framework 3.0 以 及 .NET Framework 2.0 版 本 下 应 用 程序 的 模板 。 

但 是 要 注意 ，.NET Framework 4 以 后 将 使 用 WCF 项 目 来 代替 之 前 的 Web 服务 ， 它 是 对 
Web 服务 的 优化 和 升级 。 如 图 2-12 所 示 为 创建 基于 .NET Framework 4 版 本 应 用 程序 时 的 模板 。 


图 2-12 .NET Framework 4 版 本 下 的 模板 


在 .NET Framework 4.0 中 没有 提供 与 Web 服务 相关 的 模板 。 而 .NET Framework 3.5 不 仅 提 
供 了 Web 服务 模板 ， 还 提供 了 WCF 服务 模板 。 
如 图 2-13 所 示 为 切换 到 .NET Framework 3.5 时 看 到 的 “ASP.NET Web 服务 ”模板 。 


2-13 .NET Framework 3.5 版 本 下 的 模板 


<@— 


2.3.2 ”实例 描述 


既然 使 用 记事 本 等 简单 的 文本 编辑 器 创建 和 使 用 Web 服务 非常 容易 ， 那 么 为 什么 还 要 使 
用 Visual Studio 呢 ? 其 实 答案 很 简单 ，Visual Studio 已 经 不 仅仅 是 一 种 开发 工具 ， 而 是 一 个 全 
面 的 集成 开发 平台 。 

利用 Visual Studio 为 用 户 提供 的 平台 ， 我 们 可 以 开发 、 调 试 、 测 试 、 部 署 Web 服务 ， 而 
且 可 以 通过 “智能 提示 ”功能 来 快速 完成 编码 工作 。 

下 面 使 用 Visual Studio 2010 创建 一 个 Web 服务 实现 用 户 登 录 验 证 的 功能 。 


2.3.3 ”实例 应 用 


【 例 2-3】 利用 Visual Studio 创建 Web 服务 

(1) 打开 Visual Studio 2010 的 【新 建 网 站 】 对 话 框 ， 从 顶部 的 下 拉 列 表 框 中 选择 .NET 
Framework 3.5，【 模 板 】 选 择 “ASP.NET Web 服务 ”， 更 改 【Web 位 置 】 为 “HTTP”， 再 输 
入 一 个 当前 网 站 要 保存 的 URL， 这 里 为 “http://localhost/UserWebService”， 最 后 单 击 【确定 】 
按钮 ， 如 图 2-14 所 示 。 


RR Wea ce 
月 T 人 建 2ML Web services 把 网 站 


Ss TeearsReraseva 


2-14 ”使 用 Visual Studio 2010 创建 Web 服务 


在 这 里 如 果 选 择 NET Framework 4， 将 看 不 到 ASPNET Web 服务 模板 。 


(2) 这 样 ， 我 们 的 Web 服务 网 站 就 已 经 创建 好 了 。 通 过 【解决 方案 资源 管理 器 】 窗 格 可 
以 看 到 网 站 中 包含 的 文件 和 文件 夹 ， 如 图 2-15 所 示 。 

Visual Studio 2010 自动 生成 的 名 为 Service 的 Web 服务 中 ， 包 含 两 个 文件 : Service.asmx 
和 Service.cs。 这 是 因为 在 默认 情况 下 ，Visual Studio 2010 是 使 用 “后 台 编 码 ” 形 式 创建 Web 
服务 的 。 


m= >> 
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图 2-15 创建 好 的 Web 服务 
(3) 右 击 网 站 名 称 并 在 弹出 的 快捷 菜单 中 选择 【添加 新 项 】 命 令 ， 


导 
章 构建 ASP.NET Web 服务 中 


在 弹出 的 【添加 新 项 】 


对 话 框 中 选择 【Web 服务】 模板 ， 然 后 设置 名 称 为 “UserService.asmx”， 再 单 击 【添加 】 按 


钮 ， 如 图 2-16 所 示 。 


人 


DE hs 
日 用 于 名 娃 Ww 服务 9 向 训 这 


2-16 新建 Web 服务 


(4) 打开 新 建 的 Web 服务 文件 UserService.asmx， 可 以 发 现 文件 呈 


有 只 有 一 行 代码 。 


<%@ WebService Language="C#" CodeBehind="~/App Code/UserService.cs" Class=" 


UserService" $%> 


(5) CodeBehind 属性 指定 了 与 UserService.asmx 文件 相 匹 配 的 源 代码 文件 是 


UserService.cs。 打 开 该 文件 ， 可 以 看 到 自动 生成 了 如 下 代码 : 


using System; 

using System.Collections.Generic; 
using System.Linqg; 

using System.Web; 

using System.Web.Services; 


/// <summary> 


A 37 


///UserService 的 摘要 说 明 
/// </summary> 
[WebService (Namespace = "http://tempuri.org/")] 
[WebServiceBinding (ConformsTo = WsiProfiles.BasicProfilel 1)] 
// 若 要 允许 使 用 ASP.NET AJAX 从 脚本 中 调用 此 web 服务 ， 请 取消 对 下 行 的 注释 。 
// [System.Web.Script.Services.ScriptService] 
public class UserService : System.Web.Services.WebService { 
public UserService () { 
// 如 果 使 用 设计 的 组 件 ， 请 取消 下 行 的 注释 
//InitializeComponent () 7 
} 
[WebMethod] 
public string HelloWorld() { 
return "Hello World"; 
} 
} 


(6) 接 下 来 添加 一 个 用 于 验证 用 户 的 方法 CheckLogin0， 它 的 实现 代码 如 下 。 在 这 里 为 
Web 服务 方法 加 上 WebMethod 属性 是 必需 的 ， 否 则 无 法 调用 该 方法 。 
[WebMethod (Description=" 验 证 用 户 输入 的 用 户 名 和 密码 是 否 正 确 ， 返 回 一 个 布尔 值 。") ] 


public bool CheckLogin(string name,string password) 
{ 
if (name == "admin" && password == "123456") 
{ 
return true; 


} 


else 


{ 


return false; 
} 


(7) 保存 对 文件 的 修改 ， 完 成 实例 的 制作 。 
2.3.4 ”运行 结果 


现在 ， 通 过 浏览 器 测试 创建 的 Web 服务 UserService 。 可 以 在 浏览 器 中 输入 
“http://localhost/UserWebService/UserService.asmx”， 如 图 2-17 所 示 。 


a a [x 


ET 


2-17 测试 Web 服务 
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从 图 2-17 中 可 以 看 到 UserService 是 Web 服务 的 名 字 ， 接 下 来 是 Web 服务 可 调用 的 两 个 


方法 。 这 里 单 击 CheckLogin 链接 测试 CheckLogin0 方 法 ， 如 图 2-18 所 示 。 
在 文本 框 内 输入 字符 串 ， 单 击 【 调 用 】 按 钮 会 出 现 如 图 2-19 所 示 的 结果 。 这 样 ， 用 Visual 
Studio 2010 创建 的 Web 服务 就 完成 了 。 


UserService 


音 十 此外， 这 了 二 到 和 关上- 


CheckLogin 


拉 证 用 户 条 六 的 用 记名 和 守 码 是 再 正确， 括 回 一 个 不， 
Mx 
车 要 全 用 HTTF FOST 协 讼 对 法 作 浊 行 过 ， 请 市 “ 风 有 ” 控 包 ， 


2:3:5 


图 2-18 测试 CheckLogin() 方 法 图 2-19 调用 结果 


实例 分 析 


a 


在 Visual Studio 2010 中 创建 Web 服务 时 ， 在 确定 其 位 置 时 要 注意 ， 需 要 选择 HITP， 并 
将 Web 服务 放 在 IIS 虚拟 目录 下 。 

然后 ，Visual Studio 2010 自动 生成 了 创建 Web 服务 所 需 的 类 以 及 默认 的 Web 服务 方法 。 
我 们 只 需 按 照 格式 编写 代码 就 可 以 了 ， 省 去 了 生成 以 及 编译 的 麻烦 。 


2.4 使 用 ASP.NET 测试 Web 服务 


Web 服务 的 使 用 非常 灵活 和 自由 , 在 前 面 我 们 使 用 控制 台 应 用 程序 调用 了 一 个 手动 生成 的 
Web 服务 ， 步 又 比较 繁琐 ,而且 出 现 错误 很 难 排除 。 这 一 节 ， 我 们 看 看 利用 Visual Studio 2010 
如 何在 ASP.NET 中 测试 Web 服务 。 


ci 视频 教学 : 光盘 /videos/02/ASP.NET 测试 Web 服务 ,avi 长 度 : 14 分 钟 
2.4.1 ”基础 知识 一 一 添加 服务 引用 与 Web 引用 的 区 别 


由 了 


F.NET Framework 4 默认 不 再 推荐 Web 服务 , 而 是 通过 WCF 来 实现 Web 服务 的 功能 。 


而 .NET Framework 3.5 两 者 都 支持 ， 因 此 在 添加 时 存在 一 些 差异 。 


<@— 


在 创建 基于 .NET Framework 4 的 项 目 或 者 网 站 时 ， 右 击 项 目 或 者 网 站 名 称 ， 弹 出 的 快捷 菜 
单 中 只 会 出 现 【添加 服务 引用 】 命 令 ， 如 图 2-20 所 示 。 

选择 该 项 将 打开 【添加 服务 引用 】 对 话 框 ， 在 这 里 的 【地 址 】 下 拉 列 表 框 中 可 以 输入 WCF 
的 地 址 ， 再 单 击 【前 往 】 按 钮 。 如 图 2-21 所 示 为 添加 一 个 WCEF 服务 引用 时 的 对 话 框 效 果 。 


清香 如 若 要 查看 特定 服务 器 上 的 可 用 服务 列表 ， 请 输入 服务 URL , 胡 后 单 击 “ 苇 到 ”。 若 要 浏览 可 用 的 服务 ， 请 单 击 “ 发 现 ”。 
发 布 中 地 址 他 ) 
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1 YoethatalsingDataContract 
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2-20 ”快捷 菜单 图 2-21 【添加 服务 引用 】 对 话 框 


虽然 ， 也 可 以 通过 Web 服务 的 URL 来 添加 服务 引用 。 但 是 要 注意 ， 此 方法 不 能 保证 Web 
服务 的 正常 使 用 ， 因 此 不 推荐 使 用 。 

不 过 ， 打 开 【 添 加 Web 引用 】 对 话 框 并 不 复杂 。 在 图 2-21 所 示 的 对 话 框 中 单 击 【 高 级 】 
按钮 ， 然 后 从 弹出 的 【服务 引用 设置 】 对 话 框 中 单 击 【 添 加 Web 引用 】 按 钮 即 可 ， 如 图 2-22 
所 示 。 


服务 引用 设置 
客户 端 


口 生成 异步 换 作 @@) 
数据 类 型 


集合 类型); System Array 
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加 重新 使 用 所 有 引用 的 程序 集中 的 类 型 A) 

〇 重新 使 用 所 引用 的 指定 程序 集中 的 类 型 G): 


美人 性 - 一 一 一 一 
添加 Yeb 引用 而 不 是 服务 引用 。 这 村 基于 WET Free erork 2.0 1eb 服务 技术 生成 代码 - 


添加 Web 引用 


Cj 到 ] 


2-22 【服务 引用 设置 】 对 话 框 


下 面 我 们 来 了 解 一 下 添加 服务 引用 与 添加 Web 引用 的 区 别 。 
(1) 添加 服务 引用 使 用 的 是 WCF 服务 ， 而 添加 Web 引用 使 用 的 是 Web 服务 。 


第 2 章 构建 ASP.NET Web 服务 


(2) Visual Studio 2010 在 升级 以 后 为 了 支持 NET Framework 3.0 或 3.5 版 本 上 的 WCF 
Service Library， 增 加 了 添加 服务 引用 功能 。 而 对 于 Web 服务 从 .NET Framework 1.0 开始 就 
支持 。 

(3) 同时 存在 添加 服务 引用 与 添加 Web 引用 两 者 情况 的 项 目 类 型 是 Web 服务 程序 ， 包 括 
Web Service 项 目 。 普 通 的 控制 台 和 窗 体 等 类 型 是 没有 添加 Web 引用 的 。 

(4) 使 用 添加 Web 引用 后 将 由 wsdl.exe 生成 客户 端 代理 。 而 使 用 添加 服务 引用 后 生成 客 
户 端 代理 的 命令 是 sveutil.exe。 

(5) 添加 Web 引用 生成 的 代理 可 以 被 .NET Framework 1.0 或 者 .NET Framework 2.0 的 客户 
端 调用 。 而 添加 服务 引用 生成 的 代理 只 能 被 NET Framework 3.0 以 上 的 客户 端 调用 ， 而 且 添 加 
服务 引用 后 不 仅 生 成 代理 类 ， 在 web.config 中 还 会 生成 相应 的 标记 。 

(6) 添加 Web 引用 生成 的 Reference.cs 文件 里 包含 一 个 服务 代理 类 ， 它 负责 与 Web 服务 
通信 。 它 继承 一 个 SOAP 类 ,使 用 SOAP 协议 ， 基 于 XML 语言 。 此 外 还 包含 一 些 Web 服务 类 
里 定义 的 方法 ， 和 与 之 相关 的 异步 调用 方法 和 事件 。 遵 守 .NET Web Service 的 主要 规则 。 

(7) 添加 服务 引用 生成 的 客户 端 文件 Reference.cs 也 会 反 序列 化 一 个 本 地 代理 类 ， 这 点 和 
前 者 相似 。 不 过 除了 服务 类 和 其 相关 的 一 些 别 的 类 和 契约 接口 外 , 还 有 服务 请 求 和 相应 的 信息 。 
遵循 WCF 服务 框架 的 规则 。 


技术 文档 ”| WCF 与 Web 服务 的 关系 


严格 地 说 ，Web 服务 是 行业 标准 ， 它 有 一 套 规范 体系 标准 ， 而 且 在 持续 不 断 的 更 新 完 
善 中 ， 也 就 是 Web Service 规范 ， 也 称 作 WS-* 规 范 ， 既 不 是 框架 ， 也 不 是 技术 。 

微软 的 Web 服务 实现 称 为 ASP.NET Web Service， 它 使 用 Soap 来 实现 分 布 式 环 境 里 应 
用 程序 之 间 的 数据 交互 ， 用 WSDL 来 实现 服务 接口 相关 的 描述 。 

WCF(Windows Communication Foundation) 是 一 个 分 布 式 应 用 的 开发 框架 ， 属 于 特定 的 
技术 , 或 者 平台 。 既 不 是 标准 , 也 不 是 规范 。WCF 在 一 定 程度 上 就 是 ASP.NET Web Service， 
因为 它 支持 Web Service 的 行业 标准 和 核心 协议 。 因 此 ASP.NET Web Service 能 做 的 事情 ， 
WCF 几乎 都 能 胜任 ， 跨 平台 和 语言 更 不 是 问题 。 

但 是 WCF 作为 微软 主推 的 一 个 通信 平台 ， 它 的 目标 不 仅仅 是 支持 和 集成 Web Service， 
因为 它 还 兼容 和 具备 了 微软 早期 很 多 分 布 式 技术 的 特性 ,在 本 书 的 第 13 章 将 详细 讨论 WCF。 


2.4.2 ”实例 描述 

至 此 ， 我 们 使 用 Visual Studio 2010 已 经 创建 了 一 个 Web 服务 ， 而 且 也 了 解 了 如 何在 
ASPNET 中 添加 对 Web 服务 的 引用 。 但 还 没有 涉及 如 何 调用 Web 服务 的 内 容 。 

那么 这 一 节 ， 我 们 将 基于 2.3 节 的 Web 服务 创建 一 个 ASPNET 项 目 ， 并 添加 Web 引用 实 
现 用 户 登 录 与 验证 的 功能 。 


2.4.3 ”实例 应 用 


【 例 2-4】 使 用 ASP.NET 测试 Web 服务 


< 


(1) 在 Visual Studio 2010 中 打开 2.3 节 创 建 的 解决 方案 ,再 添加 一 个 WebApplication 项 目 。 
(2) 右 击 项 目 名 称 执行 【添加 Web 引用 】 命 令 ， 在 弹出 的 【添加 Web 引用 】 对 话 框 中 单 
击 【 此 解决 方案 中 的 Web 服务 】 链 接 ， 如 图 2-23 所 示 。 


避 
| 他 了 此 wr 上 的 Yeb 服务 加 


开始 浏览 Web 服务 
使 用 访 页 作为 查找 Web 服务 的 起 她 点 。 您 可 以 单 击 下 面 的 证 接 ， 或 者 在 地 址 栏 中 说 入 
已 癌 的 URLe 
训 览 至 : 

。 本 地 计算 机 上 的 _Web 服务 


。 浏 览 UDDI 
在 您 的 本 地 网 络 上 查询 UDDI 服务 器。 十 加 引用 双 ) 


2-23 【添加 Web 引用 】 对 话 框 


(3) 此 时 Visual Studio 2010 会 自动 寻找 在 当前 解决 方案 下 所 有 项 目 中 可 用 的 Web 服务 并 
罗列 出 来 。 在 这 里 我 们 会 看 到 有 两 个 结果 : UserService 和 Service， 如 图 2-24 所 示 。 


| 此 解决 方 过 中 的 Web 服务 人 


下 面 旨 出 下 此 解决 方 实 中 可 用 的 Woh 服务 。 站 服 务 酝 辽 可 以 江上 该 服务 。 


Vserseryice Htps//localnost/UssrYe 
vi Httpi//locslhset/UoorVebSsrvice/ Sorvice. a 
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图 2-24 寻找 Web 服务 


(4) 单 击 UserService 链接 进入 该 Web 服务 的 添加 引用 页 面 ， 如 图 2-25 所 示 。 

(5) 可 以 看 到 ， 在 【Web 引用 名 】 文 本 框 里 默认 值 为 “localhost”， 它 表示 我 们 使 用 Web 
服务 时 需要 先 引 用 一 个 命名 空间 。 这 里 不 用 修改 , 单 击 【添加 引用 】 按 钮 ,Web 服务 UserService 
就 添加 到 网 站 里 了 。 


全 =》 我 们 也 可 以 在 【添加 Web 引用 】 对 话 框 的 URL 中 直接 输入 Web 服务 的 地 址 
技巧 http://localhost/UserWebService/UserService.asmx 来 转 到 添加 引用 页 面 。 


(6) 对 Web 服务 的 Web 引用 添加 完成 之 后 ， 会 看 到 【解决 方案 资源 管理 器 】 里 多 出 的 
Web References 文件 夹 以 及 文件 ， 如 图 2-26 所 示 。 
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添加 Yeb 引用 


请 定位 到 有 鞭 Yeb 服务 的 VRL， 直 后 单 十 “添加 引用”, 添加 位 于 污 VIL 上 的 所 有 可 用 服务 。 
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» Helloworld 
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2-25 ”输入 URL 后 的 添加 Web 引用 图 2-26 添加 引用 后 的 文件 夹 和 文件 


(7) 这 样 ，Web 服务 就 引用 到 网 站 里 了 。 下 面 通过 一 个 简单 的 登录 来 测试 Web 服务 是 否 
用 。 新 建 一 个 名 为 Login.aspx 的 登录 页 面 ，Default.aspx 页 面 用 于 显示 登录 后 显示 的 首页 。 

(8) Login.aspx 是 进入 首页 之 前 的 登录 页 面 ， 在 这 里 显示 了 用 户 名 和 密码 输入 框 ， 以 及 一 
个 “登录 ”按钮 。 页 面前 台 代码 如 下 : 


<table width="100%" border="0" cellspacing="0" cellpadding="0"> 
<tr> 


<td width="16%" height="25"><div align="right"><span class="STYLE1"> 用 户 
</span></div></td> 
<td width="57%" height="25"><div align="center"> 
<asp:TextBox ID="txtName" runat="server" style="width:105px; height:17px; 
background-color:#292929; border:solid lpx #7dbad7; font-size:12px; 
color:#6cd0ff"></asp:TextBox> 
</div></td> 
<td width="27%" height="25">gnbsp;</td> 
</tr> 
<tr> 
<td height="25"><div align="right"><span class="STYLE1"> 密 码 
</span></div></td> 
<td height="25"><div align="center"> 
<asp:TextBox ID="txtPwd" runat="server" style="width:105px; 
height:17px; background-color:#292929; border:solid lpx #7dbad7; 
font-size:12px color:#6cd0ff" TextMode="Password"></asp:TextBox> 


</div></td> 

<td height="25"><div align="left"> <asp:ImageButton ID="ImageButtonl" 
runat="server" ImageUrl="images/dl.gif" width="49" height="18" 
border="0" 
onclick="ImageButtonl Click" /> 

</div></td> 
</tr> 
</table> 


< 


(9) 进入 “登录 ”按钮 的 后 台 单 击 事件 中 , 编写 代码 实现 调用 Web 服务 中 的 CheckLogin0 
方法 来 验证 是 否 登录 ， 并 给 出 处 理 方式 。 代 码 如 下 所 示 : 

protected void ImageButton] Click(object sender, ImageClickEventArgs e) 

{ 


// 登 录 
string name = txtName.Text.Trim(); 
string password = txtPwd.Text.Trim(); 
localhost.UserService user = new localhost.UserService(); 
if (user.CheckLogin (name, password)) 
中 
Session["userName"] = name; 
Response.Redirect ("Default .aspx"); 
} 
else 
{ 
Page.ClientScript.RegisterStartupScript (this.GetType(), "", 
"<script>alert (' 登 录 失败 ， 请 查看 用 户 名 或 密码 是 否 正确 。') ;</script>"); 
} 
} 


在 上 述 代 码 中 ,localhost 是 UserService Web 服务 的 Web 引用 名 ,而 UserService 是 要 调用 
的 Web 服务 的 名 字 ， 在 创建 对 象 user 后 ， 就 可 以 通过 它 来 调用 Web 服务 里 的 方法 了 。 
(10) 在 Default.aspx 页 面 里 添加 一 个 Literal 标签 ， 用 来 显示 信息 。 然 后 在 后 台 添加 如 下 实 
现代 码 ， 显 示 当 前 登录 的 用 户 名 : 
protected void Page Load(object sender, EventArgs e) 
{ 
if (Session["userName"] != null) 
{ 
ltUser.Text = Session["userName"] .ToString(); 
} 
else 
i 
Response.Redirect ("Login.aspx"); 
} 


(11) 保存 对 文件 的 修改 ， 完 成 实例 的 制作 。 
2.4.4 ”运行 结果 


运行 Login.aspx 文件 打开 登录 页 面 ， 如 果 用 户 名 和 密码 输入 不 正确 将 会 弹出 错误 提示 框 ， 
如 图 2-27 所 示 。 
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图 2-27 登录 页 面 
如 果 输 入 正确 ， 在 Default.aspx 页 面 会 出 现 Web 服务 返回 的 字符 串 ， 如 图 2-28 所 示 。 
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2.4.5 “实例 分 析 


ee 


图 2-28 登录 后 的 页 面 
至 此 ， 针 对 Web 服务 的 测试 就 完成 了 。 


本 实例 主要 演示 了 在 ASP.NET 中 调用 Web 服务 的 过 程 。 这 里 ， 我 们 实现 了 一 个 用 户 登 录 


验证 的 功能 。 


但 是 要 注意 ， 添 加 引用 时 应 该 指定 一 个 有 意义 的 名 称 。 然 后 ， 使 用 “引用 名 称 .Web 服务 
名 称 ” 格 式 来 实例 化 一 个 Web 服务 类 。 接 下 来 ， 便 可 以 像 普通 类 一 样 调用 其 中 的 方法 。 
另外 要 创建 一 个 Web 服务 方法 ， 必 须 使 用 “[WebMethod]” 属 性 声明 。 


< 


@ 服务 开发 学 习 实 录 .- 训 


2.5 创建 万 年 历 Web 服务 


使 用 WebService 属性 ， 在 创建 Web 服务 时 可 以 为 该 服务 指定 所 属 的 XML 命名 空间 。 而 
且 还 可 以 使 用 一 个 字符 串 来 描述 Web 服务 的 作用 和 功能 
下 面 我 们 就 来 详细 了 解 WebService 属性 的 用 法 。 


rc 视频 教学 : 光盘 /videos/02/ 创 建 万 年 历 Web 服务 .avi 长度: 10 分钟 


2.5.1 ”基础 知识 一 一 WebService 属性 


WebService 属性 只 能 用 在 Web 服务 类 中 ， 用 于 向 Web 服务 类 添加 有 关 的 附加 信息 。 该 属 
性 由 System.Web.Service.WebServiceAttribute 类 实现 ， 包 含 的 选项 有 NameSpace、Name 和 
Description， 下 面 分 别 介 绍 这 些 选项 。 

1. Description 


Description 选项 用 于 向 Web 服务 添加 描述 信息 ， 它 将 成 为 WSDL 文档 的 一 部 分 。 例 如 ， 
下 面 的 示例 使 用 Description 选项 为 一 个 Web 服务 类 添加 描述 文字 。 

[Webservice (Description = "<strong> 天 气 预报 web 服务 : 包含 2400 个 以 上 中 国 城市 和 100 

个 以 上 国外 城市 天 气 预报 数据 ， 数 据 每 2.5 小 时 左右 自动 更 新 一 次 ， 准 确 可 靠 。</strong>") ] 

public class WeatherWebServices : System.Web.Services.WebService 

如 上 述 代码 所 示 ， 在 WebService 属性 中 添加 了 一 个 Description 选项 ， 该 选项 的 值 为 粗 体 
显示 的 字符 串 。 运 行 后 ， 这 段 描述 信息 将 出 现在 Web 服务 的 下 方 ， 如 图 2-29 所 示 。 

为 Web 服务 添加 Description 选项 后 ，ASP.NET 创建 WSDL 文件 时 ， 也 将 在 WSDL 的 服 
务 描述 文件 中 的 <documentation> 标 记 中 显示 该 描述 信息 。 此 时 ， 在 图 2-29 所 示 的 页 面 中 单 击 
“服务 说 明 ” 链 接 便 可 以 看 到 ， 如 图 2-30 所 示 。 


Toeaihos 


pe 


a 和 ea space="http:/ /tempuri.org 
WeatherWebServices hie 
oc i lentation 

天 气 预 报 Web 服 务 : ep xmins:wsdl="http:/ /schemas.xmlsoap.org/wsdl/"><strong> 
狂 所 每 2.5 小 时 左右 自动 更 帮 一 次 ， 天 气 预报 Web 服 务 。 包 爹 2400 个 以 上 中 国 城市 和 100 个 以 上 国外 

城市 天 气 预报 数据 ， 数 据 每 2.5 小 时 去 右 自 动 更 新 一 次 ， 淮 确 可 靠 。 
支持 下 列 掀 作 。 有 关 正 式 定义 ,请 查 看 服务 说 图 。 </strong></wsdl:documentation> 

«Hellowerld 


此 Web 服务 使 用 http:/ /tempuri.ora/ 作为 轩 认 命名 空间 . 
建 识 : 公开 XML Web services 之 前 ,请 更 下 默认 命名 至 同 - 


国 


EET RE 


2-29 ”查看 Description 选项 2-30 ”查看 修改 Description 选项 后 的 WSDL 


mf >> 
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2. Name 


默认 时 ，Web 服务 的 名 称 与 类 名 相同 。Name 选项 用 于 为 Web 服务 设置 一 个 与 类 不 相同 的 
名 称 。 如 下 所 示 为 一 个 修改 后 的 Web 服务 : 
[WebService (Name=" 天 气 预 报 的 Web 服务 ", Description = "<strong> 天 气 预 报 Web 服务 : 包 
含 2400 个 以 上 中 国 城市 和 100 个 以 上 国外 城市 天 气 预报 数据 ,数据 每 2.5 小 时 左右 自动 更 新 一 次 ， 
准确 可 靠 。</strong>") ] 
public class WeatherWebServices : System.Web.Services.WebService 
这 里 使 用 Web 服务 的 Name 选项 ， 为 Web 服务 指定 了 一 个 与 类 名 不 相同 的 名 称 ， 测 试 页 
面 如 图 2-31 所 示 。 在 Web 服务 的 描述 文件 WSDL 中 也 将 随 之 改变 ， 此 时 效果 如 图 2-32 所 示 。 


天 气 预报 的 WPh 服 务 Weh 服务 - Wind 


[CR -EE 


斌 中 RR 责 。 攻 天 所 WNWebj 务 人 全 ~ 3 本 - 食 业 大 天 | 箱 Mttp Jocuhort 2 前 - 目 - 口 帅 - 中- “ 


天 气 预报 的 Web 服 务 
和 居民 web 最 et oo dE 
wel 2 1 以 
et 四 羧 市 天 所 预报 数据 ， 数 据 每 2.5 小 时 左 右 自 动 更 新 一 次 ， 淮 确 
可 靠 。 ee ial ntation> 
雪 芋 下 列 乡 作 。 有 关 正式 床 多 ， 请 查看 肘 竺 说 明 ， 二 | name=' 天 气 预 猴 的 Web 服 务 Soap' bindng='tns: 天 
上 Web 服务 Soap"> 


Helloworld 


此 Web 最 务 使 用 http:/ /tempurlorg/ 作为 区 认命 名 空间 - 
建设 ; 公开 XML Web services 之 痢 ,请 更 改革 认 全 名 空间 。 


图 2-31 测试 Name 选项 图 2-32 ”查看 修改 Name 选项 后 的 WSDL 
3. NameSpace 
默认 时 ,我 们 看 到 所 有 生成 的 测试 页 都 有 这 样 一 段 文字 “此 Web 服务 使 用 http://tempuri.org/ 
作为 它 的 默认 命名 空间 。” 同 时 , 在 测试 页 中 还 说 明了 如 何 修改 命名 空间 。 可 以 通过 WebService 
属性 的 NameSpace 选项 来 完成 这 一 工作 ， 如 下 所 示 : 

[WebService (Namespace="www.iWebServices.com",Name=" 天 气 预报 的 web 服务 "， 
Description = "<strong> 天 气 预报 Web 服务 : 包含 2400 个 以 上 中 国 城市 和 100 个 以 上 国外 
城市 天 气 预报 数据 ， 数 据 每 2 . 5 小 时 左右 自动 更 新 一 次 ， 准 确 可 靠 。</strong>") ] 

public class WeatherWebServices : System.Web.Services.WebService 

除了 Description 和 Name 选项 值 的 修改 可 以 在 WSDL 文件 中 自动 更 新 外 ，NameSpace 选 

项 也 不 例外 ， 如 图 2-33 所 示 为 添加 命名 空间 后 的 WSDL 文件 效果 。 


3p.org/wsdl/"><strong> 天 气 巴 家 Web 最 务 : 
以 上 网 并 斌 市 天 气 预 轩 玉 和， 和 ot et 


图 2-33 ”查看 修改 NameSpace 选项 后 的 WSDL 


< 


>» WebService 属性 不 是 创建 Web 服务 必需 的 ， 该 属性 及 其 属性 项 被 添加 到 Web 服 
务 的 标题 中 ， 标 题 与 编译 的 代码 一 起 保存 在 程序 集中 。 


稍 
引 


2.5.2 ”实例 描述 


作为 一 名 开发 者 ， 应 该 尽量 从 用 户 角 度 出 发 ， 才 能 开发 出 用 户 体验 好 、 操 作 快 捷 的 应 用 
程序 。 

对 于 Web 服务 的 开发 也 是 如 此 。 一 个 准确 的 Web 服务 名 称 ， 再 配 上 简短 的 描述 文字 ， 可 
以 让 Web 服务 的 调用 者 更 好 地 了 解 和 使 用 它 。 
下 面 就 以 做 OA 系统 时 用 到 的 万 年 历 Web 服务 为 例 ， 来 了 解 如 何 为 Web 服务 添加 描述 。 


2.5.3 ”实例 应 用 


【 例 2-$】 创建 万 年 历 Web 服务 
(1) 打开 2.5.1 节 Web 服务 WeatherWebServices.asmx 所 在 的 解决 方案 。 
(2) 通过 【添加 新 项 】 对 话 框 增加 一 个 名 为 “wannianliWS.asmx ”的 Web 服务 。 
(3) 打开 源 代码 文件 wannianliWS.asmx.cs， 可 以 看 到 系统 自动 生成 如 下 代码 : 


using System; 
using System.Collections.Generic; 
using System.Linq; 
using System.Web; 
using System.Web.Services; 
namespace WebServicel 
{ 
/// <summary> 
/// wannianliwsl 的 摘要 说 明 
/// </summary> 
[WebService (Namespace = "http://tempuri.org/")] 
[WebServiceBinding (ConformsTo = WsiProfiles.BasicProfilel 1)] 
[System.ComponentModel .ToolboxItem(false)] 
// 若 要 允许 使 用 ASP .NET AJAX 从 脚本 中 调用 此 web 服务 ， 请 取消 对 下 行 的 注释 。 
// [System.Web.Script.Services.ScriptServicel] 
public class wannianliWS1l : System.Web.Services.WebService 
| 
[WebMethod] 
public string HelloWorld() 
{ 
return "Hello World"; 
上 


】 
上 述 代码 中 ， 加 粗 部 分 的 Namespace 属性 表示 当前 Web 服务 所 在 的 命名 空间 。 如 果 不 修 


Esc >> 
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改 ， 那 么 ASPNET 将 默认 使 用 “http://tempuri.org/”， 但 此 名 称 只 能 在 开发 过 程 中 使 用 ， 实 际 
应 用 时 必须 进行 修改 。 
(4) 然后 添加 Name 和 Description 属性 ， 代 码 如 下 : 


[WebService (Namespace = "http://www.myWebService.com/", Name=" 万 年 历 的 Web 服务 
Description=" 万 年 历 的 Web 服务 : 提供 最 精准 的 万 年 历 服务 ， 节 气 黄历 一 应 俱全 ， 每 日 号 宜 ， 详 
细 准 确 ") ] 


(5) 保存 对 文件 的 修改 ， 完 成 实例 的 制作 。 
2.5.4 ”运行 结果 


运行 后 效果 如 图 2-34 所 示 。 为 Web 服务 提供 的 名 称 显示 在 页 面 最 上 方 , 为 Web 服务 添加 
的 描述 文字 则 显示 在 Web 服务 名 称 的 下 面 。 


WE, ER, 3, 
和 


图 2-34 查看 万 年 历 Web 服务 
接 下 来 查看 Web 服务 的 描述 文件 , 单 击 【 服 务 说 明 】 链 接 打开 的 详细 页 面 ， 如 图 2-35 所 示 。 


二 部 7 日 38 四- ID QO 


schema msoap ovgl wsalyeoap/ 
pers/ im/ tenor in 


Noms someon Or 


/Snomas xmisoap org/ wsdl/ > 太 生 前 的 Web 节 务 : 科 供 家 折 极力 年 
TT 


图 2-35 ”服务 说 明 的 内 容 


2.5.5 ”实例 分 析 


ss 


WebService 属性 在 实际 开发 时 应 用 频率 非常 高 ， 这 也 与 它 的 3 个 选项 分 不 开 。Namespace 
唯一 指定 了 Web 服务 所 在 的 命名 空间 ，Name 选项 可 以 指定 一 个 别名 , 而 使 用 Description 选项 
能 够 为 Web 服务 指定 一 段 描述 它 的 功能 的 信息 。 


< 


2.6 为 Web 服务 方法 添加 说 明 


在 上 一 节 中 ， 我 们 学 习 了 如 何 对 Web 服务 类 进行 修饰 。 在 这 个 Web 服务 类 中 会 有 很 多 方 
法 ， 但 不 是 所 有 的 方法 都 可 以 通过 Web 进行 调用 ， 而 只 有 使 用 WebMethod 属性 修饰 的 方法 才 
可 以 。 

另外 ， 要 成 为 Web 服务 方法 除了 带 有 WebMethod 属性 外 ， 还 必须 声明 为 public 方法 。 
WebMethod 属性 提供 了 很 多 的 选项 来 控制 Web 服务 方法 的 行为 ， 本 节 我 们 就 来 了 解 它们 。 


9 
鲁 '， 视频 教学 : 光盘 /videos/02/ 为 Web 服务 方法 添加 说 明 实验 .avi 四 长 度 :10 分钟 


2.6.1 ”基础 知识 一 一 WebMethod 属性 


WebMethod 属性 由 System.Web.Services.WebMethodAttribute 类 实现 ， 它 包含 6 个 选 
项 来 说 明和 更 改 Web 方法 的 行为 ， 分 别 是 CacheDuration、Description、EnableSession、 
MessageName、TransactionOption 和 BufferResponse。 下 面 通过 一 些 简单 的 示例 介绍 这 些 选 项 。 


1. CacheDuration 


在 Web 服务 中 实现 适当 的 缓存 可 以 提高 可 扩展 性 和 性 能 。 实 现 缓存 系统 最 容易 的 方法 之 
一 是 使 用 WebMethod 属性 的 CacheDuration 选项 。 

使 用 CacheDuration 选项 可 以 设置 请 求 /响应 对 在 缓存 中 存储 的 秒 数 ( 整 数 )， 它 的 默认 值 为 
0， 表 示 不 缓存 响应 。 对 于 涉及 需要 大 量 处 理 器 资源 的 查询 或 者 结果 不 经 常 发 生变 化 并 且 开 销 
较 大 的 其 他 查询 的 Web 来 说 ， 这 种 缓存 机 制 是 非常 理想 的 。 例 如 ， 在 一 个 商城 系统 中 ， 获 得 
每 个 用 户 订单 信息 的 Web 方法 就 是 这 种 功能 的 例子 。 对 于 这 样 的 系统 来 说 ， 我 们 可 以 将 Web 
方法 的 CacheDuration 属性 设置 为 1 分 钟 或 者 更 长 的 时 间 ， 从 而 减少 到 数据 库 的 往返 过 程 。 
如 下 所 示 代 码 ， 演 示 了 如 何 为 一 个 Web 方法 添加 CacheDuration 选项 。 
[WebMethod (CacheDuration=60)] 


public DataSet getOrderDetailsById(string ordId) { 


// 这 里 是 具体 的 实现 ， 此 处 省 略 


} 


2. EnableSession 


ASP.NET Web 应 用 程序 最 大 的 优点 就 是 可 以 禁用 会 话 状 态 。 这 一 优点 也 适用 于 Web 服务 。 
默认 时 , Web 服务 不 支持 会 话 状态 。 大 多 数 Web 服务 被 设计 成 与 状态 无 关 的 , 以 便 实现 Internet 
的 可 伸缩 性 ， 因 为 处 于 会 话 状态 时 服务 器 上 的 每 一 个 客户 都 会 消耗 内 存 。 

但 是 ， 有 时 我 们 可 能 希望 Web 服务 支持 会 话 状态 。 我 们 可 以 对 每 一 个 方法 启用 会 话 状态 。 
要 想 对 Web 服务 方法 启用 会 话 状态 , 可 以 使 用 WebMethod 属性 的 EnableSession 选项 。 如 下 代 
码 演示 了 获取 当前 在 线 用 户 数量 的 方法 。 


m=) >> 
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[WebMethod (EnableSession=true)] 
public int getonlineUsers () { 


int count; 


if (Session["users"] == null) 
{ 
count = 10; 
} 
else 
{ 
Count = (int)Session["users"] + 100; 
} 


Session["users"] = count; 
return count; 
} 
这 里 通过 设置 EnableSession 选项 的 值 为 true 来 启用 会 话 状态 。 在 getOnlineUsers() 方 法 中 
使 用 Session 对 象 来 获取 当前 在 线 用 户 的 数量 。 
用 户 在 使 用 ASP.NET 测试 页 从 浏览 器 调用 getOnlineUsers0 方 法 时 , 将 会 获得 希望 的 结果 。 
每 次 刷新 浏览 器 时 ， 在 线 用 户 数量 都 会 增加 ， 如 图 2-36 所 示 。 


http://localhost: 2770/WontherVebSeryices, a: [ http://localhost:2170/Weatheryebservices, asax/get... 革 ] 右 区] 


加 ocuhost ¢ 互 eel bont: 


帝 收 藏 严 大 http:/1locahest 27 全 响 " 会 收 训 天 。 着 http: /flocdhost:27 全 "日 


<?xml version="1.0" encoding="utf-8" ?> <?xml version="1.0" encoding="utf-8" ?> 
<int xmlns="www-iWebservices.com'">10</int> <int xmlns="www.iWebServices.com">310</int> 


第 一 次 调用 时 多 次 调用 时 


图 2-36 使 用 EnableSession 选项 的 getOnlineUsers 方法 


3. Description 选项 和 MessageName 选项 


为 了 避免 用 户 根据 Web 服务 方法 的 名 称 来 猜测 它 的 作用 ， 我 们 可 以 对 每 一 个 Web 服务 方 
法 提供 一 个 描述 。 当 Web 服务 包含 重 载 的 Web 服务 方法 时 ， 这 样 做 是 特别 有 必要 的 。 

例如 ， 在 下 面 给 出 的 代码 中 声明 了 两 个 名 为 Calculate 的 方法 ， 一 个 接受 整 型 参数 ， 另 一 
个 接受 单 精度 浮 点 型 参数 。 

[WebMethod] 


public int Calculate (int x,int y) 
{ 
return x + Y7 
} 
[WebMethod] 
public float Calculate (float x, float y) 
{ 


< 
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return 十 Y7 


} 


这 段 程序 中 ， 使 用 重 载 的 方法 创建 了 两 个 相同 名 称 的 方法 Calculate, 但 是 两 个 方法 的 参数 
不 同 。 那 么 在 查看 这 个 页 面 时 会 出 现 运行 时 异常 ， 如 图 2-37 所 示 。 

如 图 2-37 所 示 ， 异 常 信息 中 提示 同时 使 用 了 消息 名 称 Caleulate。 这 种 情况 下 ， 可 以 为 每 
个 重 载 的 方法 使 用 WebMethod 属性 。 再 使 用 该 属性 的 Description 选项 为 Web 服务 的 方法 添加 
描述 信息 ， 使 用 MessageName 选项 更 改 它 的 名 称 。 如 下 所 示 为 修改 后 的 代码 : 

[WebMethod (MessageName="CalculateInt",， Description=" 求 两 个 整数 的 和 ") ] 


public int Calculate (int x,int y) 
{ 


return x + Y7 
¥ 
[WebMethod (MessageName = "CalculateFloat",，Description = " 求 两 个 单 精 度数 的 和 ") ] 
public float Calculate (float x, float y) 
{ 
return x + Y7 


} 
然后 再 打开 Web 服务 的 测试 页 ， 即 可 看 到 修改 后 的 效果 如 图 2-38 所 示 。 
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“/ ”应 用 程序 中 的 服务 器 错误 。 支持 下 列 持 作 。 有 站 式 定义 ， 请 查看 服务 说 明 ， 
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Messagelame=Calculaterloar” 
求 丙 个 类 捕 度 攻 的 和 


Single Calculate(Single, Single) #7 Int32 Calculate a 
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说 明 : 执行 当前 Web 请求 基本 ， 出 现 示 处理 的 异常 。 清 检查 夫 柜 院 信 息 ， 以 了 解 有 关 该 异 诅 
以 及 代码 中 导 效 异 讽 的 出 处 的 详 绚 信 息 ， 


异 富 详 细 信 息 : System nvaldOperationExcepton: Sngle Calcsiate(Singe, Single) 和 mt32 Calcslate 不 符合 
《In32 me2) 疝 时 便 用 少 息 名 称 “Calculate'， 便 用 VietMethod 目 定义 竺 性 的 Wessagevane 时 性 A 
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图 2-37 运行 异常 图 2-38 修改 后 的 效果 
4. BufferResponse 选项 


Web 方法 的 默认 行为 是 在 内 存 缓冲 区 中 存储 响应 ， 直 到 将 缓冲 区 填 满 或 者 响应 完成 为 止 ， 
这 个 存储 过 程 被 称 为 序列 化 。 在 大 多 数 情 况 下 ， 这 种 行为 是 可 行 的 ， 因 为 缓冲 可 以 减少 客户 的 
传输 数量 ， 从 而 得 到 更 高 的 性 能 。 

但 是 ， 如 果 Web 方法 返回 大 量 数据 或 者 用 很 长 时 间 来 运行 ， 那 么 客户 可 能 想 要 将 
BufferResponse 选项 设置 为 False， 来 禁用 缓冲 。 这 个 设置 会 将 响应 立即 发 送 到 客户 端 , 但 是 由 
于 结果 集 更 小 ， 因 此 这 可 能 会 降低 性 能 。 

如 下 代码 演示 了 一 个 使 用 BufferResponse 选项 的 例子 : 


m= > 


第 2 章 构建 ASP.NET Web 服务 


[WebMethod (BufferResponse = false)] 
public DataSet ExecuteSql (string sql) 
{ 

// 执 行 数据 库 查询 操作 返回 所 有 数据 集 
} 


5. TransactionOption 选项 


在 ASP.NET 中 页 面 支持 事务 处 理 功能 。 只 需 用 一 个 事务 处 理 属性 标识 ASP.NET 页 面 , 该 
页 面 中 的 所 有 代码 就 将 处 于 一 个 事务 处 理 中 。 

ASP.NET Web 服务 支持 相同 的 模式 。 我 们 可 以 把 Web 服务 方法 标识 为 支持 事务 处 理 功 
能 ， 然 后 该 方法 中 的 全 部 代码 都 将 处 于 一 个 事务 中 。 

如 果 要 为 Web 方法 设置 事务 处 理 支持 ， 可 以 像 下 面 的 示例 一 样 使 用 WebMethod 的 
TransactionOption 选项 。 


using System.EnterpriseServices; 
[WebMethod (TransactionOption=TransactionOption.Required)] 
public UpdateUserAccount (float money) 
{ 
// 此 Web 服务 方法 将 支持 事务 


由 于 事务 处 理 服务 位 于 System.EnterpriseServices 命名 空间 。 因此, 在 使 用 时 用 户 首先 需要 
在 项 目 中 添加 对 System.EnterpriseServices.dll 文件 的 引用 。 

这 里 TransactionOption 选项 是 一 个 枚 举 类 型 的 值 ， 它 位 于 System.EnterpriseServices. 
TransactionOption 命名 空间 ， 可 选 值 有 5 个 : Disabled、NotSupported、Required、RequiresNew 
和 Supported。 


Web 服务 不 能 参与 正在 进行 的 事务 处 理 。 它 通常 会 启动 一 个 新 的 事务 处 理 。Web 
注意 | 。 服务 与 客户 机 不 能 共享 事务 处 理 的 内 容 。 


2.6.2 ”实例 描述 


无 论 采 用 哪 种 方式 ， 当 我 们 创建 好 一 个 Web 服务 类 之 后 ， 剩 下 的 工作 就 是 添加 Web 服务 
方法 。 为 了 使 一 些 方法 能 够 在 客户 端 调用 ， 需 要 使 用 WebMethod 属性 进行 声明 。 

WebMethod 属性 提供 了 很 多 选项 来 控制 一 个 Web 服务 方法 。 当 然 ， 它 们 都 是 可 选 的 ， 而 
且 都 有 默认 值 。 

但 是 , 作为 一 名 开发 人 员 只 有 深入 了 解 各 个 选项 的 含义 , 才能 开发 出 适合 不 同情 形 的 Web 
服务 方法 。 


2.6.3 ”实例 应 用 


【 例 2-6】 为 Web 服务 方法 添加 说 明 


<@— 


@,. 服务 开发 学 习 实录 . 


(1) 打开 2.5.2 节 Web 服务 WeatherWebServices.asmx 所 在 的 解决 方案 。 


(2) 通过 【添加 新 项 】 对 话 框 增加 一 个 名 为 “myWebService.asmx” 的 Web 服务 。 
(3) 打开 Web 服务 myWebService.asmx.cs 后 台 代 码 文件 。 添 加 一 个 不 带 参数 的 getmfo0 
方法 ， 实 现代 码 如 下 所 示 : 


[WebMethod (Description = "用 于 判断 单 击 次 数 "，Enablesession = true, MessageName 


= "getInfoByClick")] 


public string getInfo() 


{ 


} 


int count; 
System.Web.Sessionstate.HttpSessionState Session; 
Session = System.Web.HttpContext.Current .Session; 
if (Session["clickcount"] == null) 

count = 1; 
else 

count = (int)Session["clickcount"] + 1; 
Session["clickcount"] = count; 
if (count >= 4) 
{ 

return "系统 忙 ， 请 稍 候 再 试 "; 
} 
else 
{ 

return "没有 数据 "; 


(4) 再 添加 一 个 同名 的 getInfo0 方 法 ， 这 里 为 它 设置 一 个 字符 串 参 数 ， 实 现代 码 如 下 : 


[WebMethod (Description = " 据 名 称 查 询 是 否 存在 该 用 户 "，MessageName 


"SelUserInfoBYName"，Transactionoption = TransactionOption.Required)] 
public string getInfo (string name) 


{ 


string conn; 
sterling sqly 
SqlDataReader reader; 


conn = "Data Source=.;Initial Catalog=Login;User ID=sa;Password=123"; 
sql = "select * from LoginInfo where name ='" + name + ™'"; 

try 

{ 


SqlConnection con = new SqlConnection(conn); 
SqlCommand com = new SqlCommand (sql, con); 
con.Open(); 
reader = com.ExecuteReader (); 

| 

catch (Exception e) 

{ 


return e.Message; 
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if (reader.Read()) 
| 
return "用 户 "” + name + "存在 ! "; 


} 
[3 
| 
return "不 存在 该 用 户 ! "; 
号 


} 


(5) 这 里 使 用 重 载 创建 了 两 个 名 称 相 同 的 getInfo0 方 法 。 但 是 要 注意 ， 即 使 使 用 了 
MessageName 属性 为 方法 重 命名 ， 还 是 会 出 现 如 图 2-39 所 示 的 错误 。 


Tr 
司 四 lx 
| 太 服 务 "fatservieel misservieer 不 后 全 相 . 芥 " 目 加 "TA 


“/” 应 用 程序 中 的 服务 器 错误 。 


愧 务 “WebServicel./myWebService “不 着 全 WS-I Basic Profile V1.1。 庆 共 营 下 厨 及 竺 个 所 浴 失 声 

名 六 宪 。 要 尖 局 一 我 作 葵 芋 ， 博 焰 克 应 WebServiceBinding 藉 磋 £89 ConformanceClaims 局 码 砍 

到 为 WsiClaims,None- 
说 了 


放 查 Wsdl:portTYPe 产 汉 疗 葆 作客 硬 我 。 访 时 户 所 wsdl:portTYPe 必须 肥育 

问 作 ， E23 人 类 放 6Y name 请 丝 他 不 检 采 ， 注 辣 ， 尼 要 天 代 生 用 于 蔡 站 Wsdl; portType #6 

wsdl:operations. wsdl:portType 可 能 后 育 与 考 希 Wsdl:portTypes 站 发 涡 认 有 辣 各 

wsdl:operations- 

- 关 启 协作 全 间 人 tp :Witempumi.org/ "的 portType" myWebServiceSoap”- £m “getInfo”. 
济 大 你 悍 天 司 一 绽放 入 Web 方法 


请 训 的 出 站 的 尖 信 入， 
和 消 榴 奋 W89 和 个 标准 化 声明 澡 完 。 天 用 芭 导 恰 


图 2-39 相同 方法 名 时 错误 提示 
(6) 下 面 来 解决 这 个 问题 。 在 新 建 Web 服务 时 ， 系 统 自动 生成 的 代码 中 有 如 下 代码 : 


[WebServiceBinding (ConformsTo = WsiProfiles.BasicProfilel 1)] 
我 们 需要 将 它 改 成 如 下 代码 : 


[WebServiceBinding (ConformsTo = WsiProfiles.None)] 


(7) 这 样 ， 再 次 运行 就 不 会 出 现 同样 的 错误 了 。 
2.6.4 ”运行 结果 


现在 ， 让 我 们 运行 Web 服务 看 一 下 运行 效果 。 在 浏览 器 中 输入 Web 服务 myWebService. 
asmx 所 在 地 址 ， 如 图 2-40 所 示 。 

可 以 看 到 ,现在 虽然 两 个 方法 名 相同 ,但 是 已 经 没有 错误 了 。 而 且 显示 了 使 用 MessageName 
属性 重 命名 的 方法 名 以 及 Description 属性 描述 Web 方法 的 信息 。 

这 里 我 们 先 对 有 参数 的 getInfo0 方 法 进行 测试 。 单 击 该 链接 在 进入 页 面 的 name 文本 框 中 
输入 测试 值 ， 再 单 击 【 调 用 】 按 钮 ， 如 图 2-41 所 示 。 


< 


Ga 


全 a 起 asenee Yd 


myWebService 
人 


SelUserInfoByName 
2 
" ed 
肌 于 者 疡 尘 市 次 攻 大 要 使 用 HTTP POST 者 训 江汉 作 直行 测试 ， 请 时 十 “通用 ” 拒 钮 。 
sn a 
此 web 最 各 下 车 WS-1 Basic profile v1.1. p= 
下面 征明 再 本 ER。 知人 下 中， 下 本 cuetservicrcy 了 生生 
Ee Ed 


Sonp 11 
TT 是 schp 42 请 0 响应 帮 科 。 全 抽出 位 特 表 亿 热力 于 术 ， 
POST /eyicbSerrice. osm ETTF/1.1 

< 


图 2-40 运行 Web 服务 图 2-41 调用 有 参 getinfo() 方 法 
此 时 ， 该 方法 将 对 数据 库 进行 查询 ， 根 据 查 询 结果 显示 是 否 存在 该 用 户 ， 如 图 2-42 所 示 。 


http://localhostz 277D/ayyebService. asax/SelUserintoBy#... 丑 | 回 | 区 | http://1ocalhost:2710/ayWehServicr. asax/SellserInfonyN, . . 攻 ] 扣 | 区 | 
rom 关 |[ 咏 || [x 


SO Or ne -< 国 了 同名 [xi | E Lochest 


轩 收 本 图 ht /oddbont 2 入" 旧名 者 TD- ”| | 安 R 天 | 功 httrI/leedaest:2T 丛 " 旧 - 品 篇 " Ww ” 


<?xXml version="1.,0" encoding="utf-8" ?> <?xml version="1.0" encoding="utt-8" ?> 
<string xmihe ="http:/ /tempuri.org/"> 用 户 admin 丰 在 ! </strng> ting xmhs="http://tempuri.org/"> 不 存在 该 用 户 ! </string> 


ETE PEE 


图 2-42 ”查询 用 户 是 否 存在 


现在 ， 开 始 测试 无 参 的 getInfo0 方 法 。 该 方法 主要 是 在 Web 中 开启 会 话 状态 ， 用 户 前 3 
次 调用 Web 方法 时 返回 的 结果 如 图 2-43 所 示 ; 调用 次 数 超过 4 次 的 时 候 ， 程 序 将 返回 不 同 结 


果 ， 如 图 2-44 所 示 。 
四 BR eslhort: 2170/ayvebsorvice. aonz/ soetInfofycliok... 同 回 加 


Mtn://1ocalhost :2770/ayahSeroice. asaz/gntTnfgoByClick 
T 本 加 的 区 7 DER 司 回 内 区 


而 Ioralhost 日 
三 十， 请 中 区 夫 | 攻 hitp /Novaest 2 


帘 收 届 天 。 莉 htp:/foeadlbost:27 从 "加 习 叫 ” 页 面 中 - 


Pum version="1.0" encoding="utf-8" ?> 


<Pxml version="1.0" encoding="utf-" ?> 
<string xmlns -="http:/ /tempuri.org/"> 没 有 数据 </string> <string xmns=http:/1rempuriorg/"> 系 统 候 ， 请 稍 名 再 试 </5trng> 


GEE ETY ER 


图 2-43 前 3 次 访问 图 2-44 第 4 次 访问 


2.6.5 ”实例 分 析 


es 


在 本 实例 中 ， 我 们 创建 了 两 个 同名 的 Web 服务 方法 ， 并 使 用 WebMethod 的 MessageName 
属性 进行 了 重 命名 .在 第 一 个 方法 中 使 用 了 EnableSession 属性 对 Web 服务 方法 启动 会 话 状 态 。 
在 第 二 个 方法 中 使 用 了 TransactionOption 属性 ， 使 Web 服务 与 数据 库 交 互 时 具有 事务 功能 。 

最 后 ， 提 示 一 下 ， 本 实例 所 用 的 LoginInfo 表 中 共有 三 列 ， 分 别 是 Id4、Name、 了 Password。 


m3 >> 
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2.7 ”常见 问题 解答 


2.7.1 如 何 生成 代理 类 ， 如 何 创建 一 个 Web 服务 


回国。 如何 生成 代理 类 ， 如 何 创建 一 个 Web 服务 ? 
[全 全 。 网络 课堂 : http:Wbbs.itzcn.comythread-15119-1-1.html 


如 题 ， 新 手 不 知 问题 如 下 : 

(1) 如 何 用 wsdl 文件 生成 代理 类 的 cs 文件 ? 

(2) 然后 用 这 个 代理 类 怎么 做 才能 创建 一 个 Web 服务 ? 

【解决 办 法 】 

(1) 如 何 用 wsdl 文件 生成 代理 类 cs 文件 ? 

答 ， 本 来 要 使 用 wsdl 命令 的 ， 但 如 果 有 Visual Studio 环境 的 话 ， 添 加 Web 引用 即 可 。 

例如 ， 如 下 命令 就 会 产生 一 个 xxx.cs 的 Web 服务 代理 类 。 

R:\>wsdl "http://localhost:1970/WebSite3/Service.asmx?WSDL" 

Microsoft (R) Web Services 描述 语言 实用 工具 

[Microsoft (R) .NET Framework, Version 2.0.50727.1432] 

Copyright (C) Microsoft Corporation. All rights reserved. 

正在 写 入 文件 “"R:\Service.cs”。 

(2) 然后 用 这 个 代理 类 怎么 做 才能 创建 一 个 Web 服务 ? 

答 : 只 有 先 创建 一 个 Web 服务 ， 才 能 在 客户 端 创建 代理 类 来 使 用 。 具 体 方法 是 ， 添 加 对 
Web 服务 的 引用 ， 再 实例 化 对 象 ， 然 后 调用 其 中 的 方法 。 


2.7.2 添加 Web 服务 引用 时 的 问题 


添加 Web 服务 引用 时 的 问题 ? 
网 络 课堂 : http://bbs.itzen.com/thread-15120-1-1.html 


无 法 加 载 协议 为 “CMSserver.CMSWebServiceSoap” 的 终结 点 配置 部 分 ， 因 为 找到 了 该 协 
议 的 多 个 终结 点 配置 。 请 按 名 称 指示 首选 的 终结 点 配置 部 分 。 
添加 Web 服务 引用 时 出 现 上 面 的 提示 ， 这 是 怎么 回 事 啊 ? 盼 高 手 给 出 解答 。 
【解决 办 法 】 
很 简单 , 这 是 因为 在 添加 对 CMSserver 的 引用 时 ,客户 端的 配置 文件 中 出 现 了 多 个 endPoint 
节点 造成 的 。 
解决 办 法 就 是 在 引用 服务 的 项 目 中 删除 原来 的 服务 ， 然 后 重新 引用 一 次 。 


< 


2.7.3 ”如 何 调试 Web 服务 


如 何 调试 Web 服务 ? 
网 络 课堂 : http://bbs.itzcn.conythread-15121-1-1.html 


我 在 客户 端 引用 了 Web 服务 , 想 启动 客户 端 程序 调试 代码 , 并 跟踪 到 Web 服务 接口 内 部 。 


请 问 应 该 如 何 做 ? 麻烦 详细 说 明 一 下 ! 


Web Service 是 在 我 本 机 的 程序 ! 

【解决 办 法 】 

可 以 尝试 如 下 的 步骤 。 

(1) 在 解决 方案 中 选中 Web 服务 项 目的 “网 站 ”菜单 。 

(2) 选择 【ASP.NET 配置 】， 弹 出 属性 设置 的 页 面 。 

(3) 选中 【应 用 程序 】 页 ， 找 到 “调试 和 跟踪 ”一 栏 。 

(4) 打开 【配置 调试 和 跟踪 】 选 项 卡 。 

(5) 在 【配置 调试 和 跟踪 应 用 程序 的 设置 】 下 选中 【启用 调试 】 复 选 框 。 

(6) 设置 断 点 运行 或 按 F11 键 运行 ， 然 后 就 可 以 单 步调 试 Web 服务 程序 的 代码 了 。 


2.7.4 ”Web Service 为 什么 没有 url 属性 


Web Service 为 什么 没有 url 属性 ? 
网 络 课堂 : http:Wbbs.itzcn.cony/thread-15122-1-1.html 


请 问 各 位 , 在 用 C# 编 写 Web Service 时 继承 的 是 哪个 类 ? 为 什么 我 的 Web Service 没有 url 


属性 ， 我 用 的 是 Visual Studio 自动 生成 的 代码 。 


【解决 办 法 】 
使 用 Visual Studio 时 只 需要 选择 Web Service 模板 就 行 了 , 其 他 工作 都 由 它 来 完成 。 当然， 


你 也 可 以 自己 手动 创建 一 个 Web Service。 大 致 来 说 ， 需 要 满足 以 下 几 点 要 求 。 


(1) 使 用 的 WebService 类 必须 继承 自 WebServices 类 。 

(2) 引入 WebServices 类 所 在 的 命名 空间 System.Web.Service。 

(3) 使 用 WebService 指令 声明 当前 为 一 个 Web Service。 

(4) 使 用 “[WebMethod]” 为 类 添加 Web 服务 方法 。 

(5) 使 用 .asmx 为 扩展 名 保存 Web 服务 文件 。 

例如 ， 下 面 给 出 一 个 简单 得 不 能 再 简单 的 例子 。 

<%@ WebService Language="C#" Class="TestWebService " %> 
using System.Web.Services; 

public class TestWebService:WebServices 


{ 
[WebMethod] 
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public string Hello() 
{ 


return "Hello"s; 


} 


2.7.5 WebMethod 和 WebMethod() 有 什么 区 别 


面 sy 请 问 WebMethod 和 WebMethodO0 有 什么 区 别 ? 
有 网 络 课堂 : http://bbs.itzcn.com/thread-15123-1-1.html 


刚刚 接触 Web 服务 ， 看 到 有 些 带 括号 ， 有 些 不 带 的 ， 有 什么 区 别 呢 ? 
比如 : 


[WebMethod] 
public string HelloWorld() 
和 
return "Hello World"; 
} 
[WebMethod()] 
public DataSet GetACCData(string TBName, string tiaojianl) 
§ 


string x = Server.MapPath ("person.mdb"); 

string f = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + x; 
OleDbConnection ACConn = new OleDbConnection (f); 

DataSet DS = new DataSet () 7 

string k = "SELECT * From " + TBName + " where 姓名 like '%" + tiaojianl + 
得 二 全 坟 

OleDbDataAdapter NComm = new OleDbDataAdapter(k, ACConn); 

NComm.Fill (DS, TBName); 

return DS7 


【解决 办 法 】 
在 Web 服务 中 ， 每 个 要 对 外 公布 的 方法 名 上 面 必须 加 一 个 WebMethod， 而 在 括号 里 面 是 
给 WebMethod 的 各 个 属性 赋值 的 ! 
WebMethod 有 6 个 属性 : Description、EnableSession、MessageName、TransactionOption、 
CacheDuration 和 BufferResponse。 


例如 “WebMethod(EnableSession = true) ”就 表示 在 这 个 WebMethod 方法 中 可 以 访问 Session 
中 的 值 。 默 认 情况 下 WebMethod 是 禁用 Session 的 ! 


2.8 习 题 


一 、 填 空 题 
(1) Web 服务 方法 需要 添加 标签 才能 调用 。 


< 


(2) 为 了 方便 其 他 程序 进行 代理 ， 我 们 需要 将 创建 好 的 C# 文 件 编译 成 

(3) 我 们 可 以 通过 实用 程序 为 Web 服务 创建 代理 类 。 

(4) WebService 的 Description 属性 用 于 向 Web 服务 添加 描述 信息 , 它 被 放 到 了 
文档 里 。 

(5) 有 一 个 使 用 C# 编 写 的 Web 服务 位 于 http://localhost/test.asmx， 可 以 使 用 
命令 生成 代理 。 


wsdl /1:cs /n:aSpace http://localhost/test.asmx 


(6) 使 用 记事 本 创建 一 个 Web 服务 必须 继承 类 ， 它 位 于 
空间 。 
二 、 选 择 题 
(1) ASPNET Web 服务 存在 于 扩展 名 为 的 文件 中 。 
A. .asmx B. .aspx CGC inex D. .dll 


(2) 在 用 户 创建 代理 前 ， 应 当 确保 系统 中 安装 了 某 些 实用 程序 ， 下 列 
须 的 。 


A. wsdl.exe B. vbc.exe C. vab.exe D. csc.exe 
(3) 下 面 不 是 WebService 处 理 指令 可 以 使 用 的 属性 是 
A. WebMethod B. Language 
C. Codebehind D. Class 
(4) 以 下 代码 块 中 ， 需 要 在 空格 处 填写 的 代码 是 
[WebMethod( ) 
public string getCurrentUsers() { 
if (Session["users"] == null) 


{ 


return ""; 


} 
else 
{ 
return Session["users"] .ToString(); 


} 


A. MessageName = getCurrentUsers 
B. CacheDuration=60 
C. EnableSession=true 
D. BufferResponse =true 
(5) 在 一 个 Web 服务 类 中 ， 下 面 方法 能 够 被 正确 调用 。 
A. 
[WebMethod] 
public string Hello() 
| 


return “Hellors 
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} 


B. 
[WebMethod] 
public static string Hello() 
,| 
return "Hello"; 


| 
Cs 


public static string Hello() 
return "Hello"; 

} 

D, 

public string Hello() 
IEEGrn HLLON 


外 
(6) 下 面 不 属于 服务 引用 与 Web 引用 的 区 别 是 
A， 服务 引用 与 Web 引用 都 使 用 wsdl 命令 来 生成 代理 
B. 在 Web 应 用 程序 中 可 以 同时 引用 服务 和 Web 
C. 窗 体 应 用 程序 只 有 添加 服务 引用 
D. 服务 引用 生成 的 代理 只 能 被 NET 3.0 以 上 的 客户 端 调用 
(7) 使 用 WebMethod 属性 的 TransactionOption 选项 可 以 为 方法 启用 事务 功能 ， 下 面 不 属 
于 该 选项 值 的 是 
A. Disabled B. Enable C. NotSupported D. Supported 
三 、 上 机 练习 


上 机 练习 1: 模拟 一 个 网 上 银行 支付 平台 Web 服务 。 

在 本 章 中 ， 我 们 主要 学 习 了 如 何 创建 一 个 Web 服务 ， 和 如 何在 项 目 中 引用 Web 服务 ， 也 
学 习 了 Web 服务 的 属性 和 WebMethod 的 属性 。 

本 次 上 机 练习 中 ， 我 们 将 通过 模拟 一 个 网 上 银行 支付 平台 ， 来 进一步 加 深 对 Web 服务 的 
认识 。 效 果 图 如 图 2-45 所 示 。 


GOO- En 
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当前 消费 : [850 
用 户 卡号 ，|987554321 


2-45 ”最 终 效果 图 
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内 容 摘要 : 

XML 是 Web 服务 的 基础 之 一 ， 渗 透 到 了 Web 服务 的 各 个 层次 。 也 就 是 说 如 果 没 有 XML 
就 没有 Web 服务 。 在 本 书后 面 介绍 Web 服务 的 各 种 相关 技术 时 ， 都 会 涉及 XML 及 其 相关 术 
语 ， 例 如 : XML 元 素 、 属 性 、 命 名 空间 等 。 如 果 你 对 这 些 概念 不 够 了 解 ， 加 之 于 不 能 在 开发 
过 程 中 熟练 地 使 用 ， 那 在 以 后 学 习 Web 服务 时 就 会 感到 非常 吃力 和 困惑 。 

因此 本 章 将 详细 介绍 XML， 包 括 XML 的 简介 、XML 的 声明 、XML 的 属性 、XML 的 命 
名 空间 、XML 的 实体 引用 以 及 DTD 等 。 

学 习 目 标 : 

@ 了 解 什么 是 XML 
掌握 XML 的 标记 与 元 素 
熟悉 XML 中 的 属性 
熟练 掌握 XML 中 命名 空间 的 使 用 
掌握 实体 引用 以 及 CDATA 的 使 用 
熟练 使 用 文档 类 型 定义 DID 


3.1 ”和 我 一 起 学 XML 


提 及 HIML， 我 想 大 家 并 不 陌生 ， 甚 至 会 很 自豪 地 说 : 我 从 事 美工 ， 对 HTML 的 研究 简 
直 就 到 了 炉火纯青 的 地 步 。 但 是 ， 随 着 技术 的 发 展 ， 你 有 没有 感觉 到 HTML 语言 的 可 扩展 性 
不 强 呢 ? 我 想 ， 答 案 是 肯定 的 。 眼 下 ， 长 江 后 浪 推 前 浪 ， 专 家 怎 能 容忍 HTML 语言 的 局 限 性 
继续 存在 呢 ? 因此 就 有 了 灵活 性 很 高 的 XML 标记 语言 。 

下 面 我 们 来 看 一 下 XML 的 发 展 史 。 

XML 是 从 1996 年 开始 有 其 雏形 ， 并 向 W3C( 全 球 信息 网 联盟 ) 提 案 ， 而 在 1998 年 2 月 发 
布 为 W3C 的 标准 (XML1.0)。XML 的 前 身 是 SGML(Standard Generalized Markup Language， 标 
准 通用 标识 语言 )， 是 自 IBM 从 20 世纪 60 年 代 就 开始 发 展 的 GML(Generalized Markup 
Language， 通 用 标识 语言 ) 标 准 化 后 的 名 称 。 

随 着 Web 的 广泛 应 用 ，W3C 逐渐 意识 到 HTML 的 局 限 性 ， 主 要 有 以 下 几 点 。 

@ 不 能 解决 所 有 解释 数据 的 问题 ,例如 : 影音 文件 或 化 学 公式 、 音 乐 符号 等 其 他 形态 的 

内 容 。 

@ ”效率 问题 ,例如 : 需要 下 载 整 份 文件 ， 才 能 开始 对 文件 做 搜索 的 动作 。 

@ 扩充 性 、 弹 性 、 易 读 性 均 不 佳 。 

为 了 解决 以 上 问题 ， 专 家 们 使 用 SGML 为 基础 ， 并 依照 HTML 的 发 展 经 验 ， 制 订 出 一 套 
使 用 时 规则 严谨 ， 但 是 描述 简单 的 语言 XML。XML 是 在 这 样 的 背景 下 诞生 的 一 一 能 否 有 一 
个 更 中 立 的 方式 描述 简单 的 ， 让 消费 端 自行 决定 要 如 何 消化 、 呈 现 服务 端 提供 的 信息 ? 

XML 被 广泛 用 来 作为 跨 平 台 之 间 交 互 数据 的 形式 ， 主 要 针对 数据 的 内 容 。 通 过 不 同 的 格 
式 化 描述 手段 (XSLT 或 者 CSS) 可 以 完成 最 终 的 形式 表达 (生成 对 应 的 HTML、PDF 或 者 其 他 的 
文件 格式 )。XML 的 目的 在 于 提供 一 个 对 信息 能 够 做 精准 描述 的 机 制 ， 从 而 弥补 HTML 太 过 于 
表现 导向 的 不 足 。 

下 面 我 们 就 来 具体 介绍 什么 是 XML 。 


< 视频 教学 : 光盘 /videos/03/XML 简介 avi @@ 长 度 : 6 分 名 


XML(Extensible Markup Language， 可 扩展 标记 语言 ) 与 HTML 一 样 ， 都 是 SGML。 与 其 他 
语言 不 同 的 是 : XML 没有 规定 的 标记 , 即 用 户 可 以 根据 需要 自行 创建 符合 XML 规范 的 标记 来 
描述 XML 文档 要 表达 的 内 容 。 

XML 也 是 一 种 元 标记 语言 ， 可 用 于 定义 其 他 与 特定 领域 有 关 的 、 语 义 的 、 结 构 化 的 标记 


语 


ml 


通过 上 面 的 介绍 ， 我 们 了 解 到 XML 是 一 种 可 以 自行 创建 的 标记 语言 。 用 户 自己 创建 标记 
与 元 素 ， 不 仅 用 户 能 够 理解 文档 的 内 容 ， 而 且 具 有 相当 高 的 灵活 性 。 另 外 XML 标记 的 主要 特 
征 是 将 内 容 与 其 表示 相 分 离 。 

上 面 提 到 XML 允许 用 户 创建 标记 与 元 素 , 但 需要 遵循 文档 规范 。 那 么 如 何 保证 遵循 XML 
的 文档 规范 呢 ? 很 简单 ， 每 个 XML 都 遵循 一 定 的 文档 结构 。 下 面 我 们 就 来 详细 介绍 XML 的 
文档 结构 。 
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1) 序言 

序言 是 XML 文档 的 开始 ， 用 来 表示 对 XML 数据 进行 编译 的 开始 以 及 描述 字符 的 编码 
高 起 

XML 文档 的 序言 主要 包括 XML 的 声明 和 注释 两 部 分 。XML 的 声明 用 来 说 明 该 文档 是 一 
个 XML 文档 ， 并 且 指定 该 文档 使 用 的 编码 方式 。 注 释 则 是 用 来 说 明 该 XML 文档 有 什么 特点 ， 
以 便 用 户 对 文档 理解 的 更 加 清晰 、 透 彻 。 

2) 主体 

主体 即 是 XML 文档 用 来 描述 数据 的 ， 通 常 由 标记 、 元 素 和 属性 组 成 。 


3.2 创建 一 个 简单 的 XML 文档 


我 是 一 个 购物 爱好 者 ， 看 到 比较 漂亮 而 且 实惠 的 商品 我 总 是 第 一 时 间 订 购 。 对 于 经 济 并 不 
富裕 的 我 来 说 ， 总 是 偏爱 于 那些 打折 的 商品 ， 因 此 我 时 刻 关 注 着 某 些 商 品 的 打折 信息 。 不 知道 
大 家 是 否 仔 细 观 察 过 ,在 街道 两 边 的 商品 每 隔 一 段 时 间 打 折价 都 不 相同 ， 当 时 我 就 在 想 这 么 多 
商品 ， 每 件 商品 的 打折 都 不 相同 ， 如 果 要 一 个 一 个 地 标记 岂 不 是 太 麻烦 了 吗 ? 以 前 丽 怕 是 这 样 
吧 ， 但 是 现在 我 们 可 以 变通 一 下 ， 使 用 XML 文档 来 标记 这 些 商 品 的 打折 价 是 一 个 很 不 错 的 选 
择 哦 。 

下 面 就 以 简单 的 XML 文档 来 讲 一 下 ， 如 何 使 数据 更 易于 扩展 和 更 新 。 


如 视频 教学 : 光盘 /videos/03/ 创 建 一 个 XML 文档 .avi 人 @ 长 度 :12 分钟 


3.2.1 基础 知识 一 一 XML 的 声明 和 注释 


XML 的 声明 以 “<?xml” 开 始 ， 以 “?> ”结束 。 例 如 : 


<?xml version="1.0" encoding="utf-8" standalone="yes" ?> 


在 上 述 代码 中 ，“<? ?>” 中 的 各 个 参数 的 含义 如 下 。 

@ version: 指定 XML 的 版 本 号 。 通 常情 况 下 Web 支持 的 是 XML 1.0 的 版 本 。 

@ ”encoding: 指定 XML 文档 的 编码 格式 .常见 的 有 UTF-8 和 GB2312 两 种 ,默认 为 UTF-8。 

@ standalone: 指定 使 用 DTD 的 形式 ， 有 两 个 值 : yes 或 no。XML 文档 的 默认 值 是 no， 
则 说 明 需 要 引用 外 部 实体 。 否 则 说 明 所 有 必须 的 实体 声明 都 包含 在 文档 中 。 

XML 注释 是 对 文档 结构 或 者 内 容 的 解释 ， 由 于 它 不 属于 XML 文档 的 内 容 ， 因 此 XML 解 

析 器 不 会 处 理 。 注 释 以 “<!--” 开 始 ， 以 “--> ”结束 。 其 语法 格式 如 下 所 示 : 
<!-- 需要 注释 的 内 容 --> 


注释 主要 可 以 用 在 文档 的 序言 部 分 、 文 档 的 文本 内 容 中 以 及 文档 之 后 。 但 是 “--> ”字符 不 
能 用 在 注释 的 内 部 ， 由 于 解析 器 一 旦 碰 到 “-->” 就 会 看 做 一 个 注释 的 结束 ， 而 后 面 的 内 容 则 被 
作为 普通 的 XML 文档 处 理 。 对 于 其 他 合乎 规范 的 XML 字符 均 可 出 现在 注释 的 内 部 。 


<@— 


3.2.2 ”基础 知识 一 一 XML 的 标记 与 元 素 


众所周知 ， 在 HTML 语言 中 ， 我 们 使 用 预先 定义 好 的 标记 来 完成 文档 。 例 如 : 我 们 来 做 
一 位 明星 的 履历 。 代 码 如 下 所 示 : 


<qt> 明 星 信息 
<qd> 我 最 喜爱 的 明星 信息 
<ul> 
<1i>A 明星 </1i> 
<1i> 男 </1i> 
<1i>1.78m</1i> 
<1i> 篮 球 、 唱 歌 </1i> 
<1i> 眼 泪 ， 是 成 长 的 代价 。 如 哪 天 ， 你 的 泪 不 再 流 了 ， 想 说 ， 那 不 是 你 大 了 ， 而 是 ， 你 的 心 已 经 死 
LE 
</ul> 
</dd> 
</dt>. 


在 上 述 代 码 中 ， 我 们 使 用 的 是 HTML 标记 语言 ， 而 且 只 能 使 用 预先 定义 好 的 标记 来 完 
成 。 但 XML 文档 就 不 同 了 ， 我 们 可 以 自 定 义 标记 。 同 样 定义 明星 的 履历 ， 可 以 写成 如 下 所 示 
的 代码 : 
<?xml] Version="1.0"” encoding="utf-8" ?> 
< 明星 > 
< 名 称 >A 明星 </ 名 称 > 
< 性 别 > 男 </ 性 别 > 
< 身高 >1 .78m</ 身 高 > 
< 爱好 > 篮球 、 唱 歌 </ 爱 好 > 
< 格言 > 眼泪 ， 是 成 长 的 代价 。 如 哪 天 ， 你 的 泪 不 再 流 了 ， 想 说 ， 那 不 是 你 大 了 ， 而 是 ， 你 的 心 已 经 死 
了 </ 格 言 > 
</ 明 星 > 


从 上 述 代码 中 可 以 看 出 XML 的 标记 是 由 “< >” 来 定义 的 。 左 边 以 尖 括 号 “<” 开 始 ， 右 
边 以 尖 括 号 “>” 结 束 ， 且 中 间 含 有 数据 的 标记 被 称 为 非 空 标记 。 在 上 述 XML 文档 中 ，“< 名 
称 >” 和 “</ 名 称 >” 都 是 标记 ，“< 名 称 >”、“< 性 别 >” 等 被 称 为 开始 标记 ，“</ 名 称 >”、 
“</ 性 别 >” 等 被 称 为 结束 标记 。 


| 在 XML 文档 中 ， 标 记 都 是 成 双 成 对 出 现 的 ， 有 开始 标记 就 少不了 结束 标记 。 

你 可 能 会 疑惑 ， 既 然 有 非 空 标记 ， 那 么 是 不 是 有 空 标记 呢 ， 答 案 是 肯定 的 。 

在 XML 文档 中 ， 标 记 可 以 分 为 非 空 标 记 和 空 标记 。 

下 面 来 看 一 下 空 标记 是 如 何 定义 的 。 

空 标记 是 以 尖 括号 “<” 开 始 ， 以 尖 插 号“ 户 ”结束 的 标记 。 由 于 空 标记 不 包含 任何 内 容 ， 
因此 空 标记 没有 开始 标记 和 结束 标记 。 但 空 标记 中 可 以 包含 属性 ， 下 面 我 们 使 用 空 标记 来 描述 
一 下 明星 的 履历 。 代 码 如 下 所 示 : 


m= >> 
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<?xml version="1.0" encoding="utf-8" ?> 
< 明星 名 称 ="A 明星 ”性 别 =" 男 ”身高 ="1.78m" 爱好 =" 篮 球 、 唱 歌 "” 格言 =" 了 眼泪 ， 是 成 长 的 代价 " 
VE 


在 上 述 代码 中 ，“ 姓 名 ”、“ 性 别 ”、“ 身 高 ”、“ 爱 好 ”等 均 是 标记 明星 包含 的 属性 。 
人 @ | 这 里 提 到 了 XML 的 属性 ， 在 本 章 后 面 将 对 它 进 行 详细 介绍 ， 


通过 上 面 对 标 记 的 介绍 ， 我 们 了 解 了 如 何 定义 标记 ， 下 面 就 来 介绍 XML 文档 中 的 元 素 。 

元 素 是 XML 文档 中 最 重要 的 组 件 ， 用 来 描述 此 文档 所 包含 的 数据 。 在 XML 文档 中 有 且 
只 有 一 个 根 元 素 ， 其 他 元 素 是 在 根 元 素 内 部 以 树 状 的 结构 来 显示 的 。 

同样 在 XML 文档 中 ， 元 素 可 以 分 为 非 空 元 素 和 空 元 素 两 种 类 型 。 首 先 来 看 一 下 什么 是 非 
空 元 素 。 

所 谓 非 空 元 素 是 由 开始 标记 、 结 束 标记 以 及 两 标记 之 间 的 数据 构成 的 。 而 开始 标记 和 结束 
标记 用 来 描述 标记 之 间 的 数据 ， 所 以 说 这 个 标记 之 间 的 数据 就 被 称 为 元 素 的 值 。 下 面 来 看 一 下 
非 空 元 素 的 语法 格式 ， 如 下 所 示 : 

< 开始 标记 > 描述 的 数据 (元 素 的 值 ) </ 结 束 标记 > 


在 前 面 我 们 学 习 了 空 标 记 ， 其 实 空 标记 和 空 元 素 的 格式 是 一 样 的 。 在 XML 解析 器 中 ， 程 
序 对 空 元 素 和 空 标记 的 处 理 是 相同 的 ， 因 此 二 者 的 作用 是 等 价 的 。 下 面 来 看 一 下 空 元 素 的 定 
义 吧 。 
所 谓 空 元 素 就 是 不 包含 任何 内 容 的 元 素 。 语 法 格式 如 下 所 示 : 
< 开始 标记 ></ 结 束 标记 > 
空 元 素 的 语法 格式 还 可 以 这 样 写 ， 如 下 所 示 : 
< 开始 标记 /> 
为 了 更 好 地 了 解 XML 文档 的 元 素 ， 我 们 通过 一 个 简单 的 XML 文档 来 说 明 一 下 。 代 码 如 
下 所 示 : 
<?xml] version="1.0" encoding="utf-8" ?> 
< 用 户 > 
< 编号 ID="123"” ></ 编 号 > 
< 用 户 名 >dcy</ 用 户 名 > 
< 身高 >1. 67m</ 身 高 > 
< 爱好 > 爱 的 供养 </ 爱 好 > 
</ 用 户 > 
在 该 文档 中 ，“ 用 户 ” 是 文档 的 根 元 素 ， 根 元 素 内 部 有 4 个 子 元 素 ， 分 别 是 : 编号 、 用 户 
名 、 身 高 和 爱好 。 其 中 “< 编号 ID="123" ></ 编 号 >” 是 一 个 空 元 素 ， 而 其 他 的 三 个 子 元 素 均 是 
非 空 元 素 。 当 然 “< 编 号 ID="123" ></ 编 号 >” 空 元 素 还 可 以 这 样 写 ， 代 码 如 下 所 示 : 


< 编号 ID="123" /> 


< 


瞧 ， 


这 样 是 不 是 简化 了 XML 文档 啊 。 


俗话 说 “没有 规矩 不 成 方圆 ”, 在 任何 编程 语言 中 都 有 特定 的 语言 规范 , 那么 同样 在 XML 
文档 中 为 了 更 能 准确 地 描述 数据 ， 也 有 一 套 命名 规则 。 下 面 我 们 来 看 一 下 XML 标记 和 元 素 的 
命名 规则 ， 如 下 所 示 。 


3.2.3 


标记 或 元 素 名 称 须 以 字母 、 下 划 线 “ ”或 者 中 文 开头 ， 不 能 以 数字 或 者 标点 符号 开 
头 。 例 如 : <_name>、<name>、< 名 称 name> 等 命名 都 是 正确 的 。 

元 素 名 中 可 以 包含 字母 、 数 字 及 其 他 字符 ， 如 <name>、< 用 户 名 >、<ab123> 等 。 但 并 
不 是 所 有 的 软件 都 能 很 好 地 支持 中 文 的 命名 ， 所 以 尽量 使 用 英文 来 命名 。 在 XML 文 
档 中 ， 不 要 使 用 “:” 来 命名 ， 此 字符 会 在 XML 命名 空间 中 用 到 。 

元 素 名 称 不 能 以 XML 的 任意 形式 开头 (如 XML 或 者 Xml 等 )。 例 如 : <xmlBook>、 
<XMLbook>、<XmlBook> 等 。 

名 称 中 不 能 包含 空格 ， 例 如 : <abc abc>。 

文档 中 标记 必须 对 应 ， 也 就 是 说 ， 在 XML 文档 中 只 要 有 开始 标记 ， 就 必须 有 结束 
标记 。 

标记 区 分 大 小 写 ， 例 如 <name> 和 <Name> 是 两 个 完全 不 同 的 标记 。 

元 素 标记 必须 要 合理 地 进行 嵌 套 。 


实例 描述 


我 朋友 家 是 开 超市 的 ， 我 去 那里 帮忙 ， 恰 巧 碰 到 厂家 来 送 货 ， 朋 友 交 代 我 将 这 些 商 品 的 价 
格 记录 下 来 ， 并 且 将 记录 下 来 的 商品 分 一 下 类 。 这 样 我 就 一 直 在 那里 记录 ， 但 是 不 久 就 把 我 自 
己 给 搞 晕 了 ， 这 样 的 记录 连 我 自己 都 看 不 明白 ， 更 别提 别人 了 。 突 然 间 我 想 能 不 能 使 用 XML 
文档 来 将 这 些 商品 进行 总 体 分 类 呢 ， 然 后 将 属于 某 一 类 的 商品 作为 其 类 的 子 元 素 。 

因为 XML 的 可 扩展 性 很 高 ， 并 且 很 容易 维护 和 修改 。 这 样 想 过 之 后 ， 我 就 马上 行动 起 来 
了 ， 很 快 我 就 将 这 些 商 品 分 类 成 功 了 。 我 不 得 不 惊叹 学 以 致 用 真得 很 重要 。 

下 面 就 来 看 一 下 我 的 实现 方案 。 


3.2.4 


实例 应 用 


【 例 3-1】 创建 一 个 简单 的 XML 文档 
(1) 首先 创建 一 个 名 称 为 GoodsXml 的 XML 文档 。 
(2) 在 GoodsXml 文件 中 添加 如 下 代码 所 示 : 


<?xml version="1.0" encoding="utf-8" ?> 


<goods> 
<SkinCare> 


<anti wrinkle> 


<SkinName> 真 奢华 </SkinName> 
<SkinPrice>450 元 </SkinPrice> 
<SkinEffect> 去 干 纹 </SkinEffect> 


</anti wrinkle> 
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<hydrating> 
<SkinName>dermare</SkinName> 
<SkinPrice>250 元 </SkinPrice> 
<SkinEffect> 双 因子 补水 维护 精华 </SkinEffect> 
</hydrating> 
<whitening > 
<SkinName> 美 白 </SkinName> 
<SkinPrice>270 元 </SkinPrice> 
<skinEffect> 美 白 维护 精华 </skinEffect> 
</whitening> 
</SkinCare> 
<shampoo> 
<repair > 
<shampooName> 潘 婷 < /shampooName> 
<shampooPrice>50 元 </shampooPrice> 
<shampooEffect> 修 复 干枯 洗 发 露 </shampooEffect> 
</repair> 
<Prevent> 
<shampooName> 迪 彩 < /shampooName> 
<shampooPrice>30 元 </shampooPrice> 
<shampooEffect> 防 干枯 洗 发 露 </shampooEffect> 
</Prevent> 
</shampoo> 
</goods> 


(3) 保存 上 面 对 文件 的 修改 。 


司 局 | 


TE 


hampeoName 半生 </shampocName> 
hampoonnice >50s </shampooP ice > 
shampooEffect > 多 和 和 由 流 和 重 </shamooosffect> 


图 3-1 商品 的 分 类 效果 


人 


< 


3.2.6 ”实例 分 析 


a 


在 本 实例 中 ， 我 们 使 用 商品 goods 作为 此 文档 的 根 元 素 ， 以 护肤 品 SkinCare 和 洗 发 露 
shampoo 作为 此 根 元 素 的 子 元 素 .接着 anti wrinkle、hydrating 和 whitening 则 是 子 元 素 SkinCare 
下 的 腐 套子 元 素 ， 而 repair 和 Prevent 则 是 子 元 素 shampoo 下 的 商品 。 瞧 ， 这 样 是 不 是 很 容易 
就 能 增加 商品 的 分 类 或 者 修改 商品 的 价格 。 


3.3 XML 的 属性 


学 过 HTML 语言 的 人 都 知道 ， 要 想 为 预先 定义 好 的 标记 设置 样式 时 ， 可 以 使 用 内 获 样 式 
或 者 外 部 样式 。 例 如 : 使 用 table 标签 创建 一 个 背景 色 为 红色 、 边 框 为 1 像素 、 边 框 颜色 为 蓝 
色 的 表格 。 如 果 使 用 内 嵌 样 式 ， 就 会 用 到 此 标签 中 的 bgcolor、border、bordercolor 等 属性 。 那 
么 在 XML 标记 语言 中 有 没有 类 似 的 属性 呢 ， 答 案 是 肯定 的 。 

下 面 就 来 看 一 下 XML 的 属性 。 


(Ne 视频 教学 : 光盘 /videos/03/ 我 的 属性 .avi 人 @@ 长 度 : 6 分 钟 


XML 属性 是 将 一 些 额外 的 信息 附加 到 元 素 上 ， 从 而 使 文档 对 元 素数 据 描述 得 更 加 有 具体 。 
如 果 用 户 不 喜欢 通过 子 元 素来 描述 元 素 的 一 些 特性 ， 那 么 使 用 属性 来 存储 会 是 一 个 不 错 的 选 
择 。 属 性 一 般 在 开始 标记 中 声明 ， 由 属性 名 和 值 构成 。 下 面 来 看 一 下 如 何在 非 空 元 素 中 添加 属 
性 ， 语 法 如 下 所 示 : 
< 标记 名 属性 列表 > 描述 的 数据 </ 标 记名 > 
在 空 元 素 中 添加 属性 ， 语 法 如 下 所 示 : 
< 标记 名 属性 列表 > </ 标 记名 > 或 者 < 标记 名 属性 列表 /> 
下 面 我 们 使 用 属性 来 描述 一 下 今天 的 公交 车 情况 ， 代 码 如 下 所 示 : 
<?xml] version="1.0" encoding="utf-8" ?> 
< 公交 车 > 
< 车 95 长 ="4m” 宽 ="3m" 数量 ="40 人 "” > 拥挤 </ 车 95> 
< 车 K6 长 ="4m" 宽 ="3m" 数量 ="20 人 " > </ 车 K6> 
</ 公 交 车 > 
在 非 空子 元 素 “ 车 95” 中 , 属性 长 、 宽 、 数量 描述 了 此 路 车 的 拥挤 状况 。 而 在 空子 元 素 “ 车 
K6” 中 ， 属 性 长 、 宽 、 数 量 描述 了 此 路 车 的 宽松 状况 。 
在 XML 中， 标记 和 元 素 有 命名 规则 ， 那 么 属性 是 不 是 也 需要 遵循 一 些 命名 规范 呢 ， 下 奋 
我 们 就 来 看 一 下 。 


mf) >> 
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@ ”属性 名 的 命名 规则 和 元 素 的 命名 规则 相同 , 可 以 由 字母 、 数字 、 中文 以 及 下 划 线 组 成 ， 

但 必须 以 字母 、 中 文 或 者 下 划 线 开头 。 

属性 名 同样 也 区 分 大 小 写 。 

属性 值 必须 使 用 单 引 号 或 者 双 引 号 。 例 如 : “name” 和 “name” 描 述 的 是 相同 的 属 

性 值 。 

@ ”如 果 属 性 值 中 需要 使 用 左 尖 括号 “<”、 右 尖 括 号 “>”、 连 接 符号 “&”、 单 引号 “ 
或 者 双 引 号 “”” 时 ， 必 须 使 用 实体 引用 。 


\ 
攻关 | 。 在 这 里 提 到 的 实体 引用 ， 在 本 章 后 面 将 对 它 进行 详细 介绍 。 


在 XML 文档 中 ， 使 用 子 元 素 和 属性 都 可 以 实现 对 数据 描述 信息 的 存储 。 下 面 我 们 使 用 子 


元 素来 描述 该 文档 的 数据 信息 ， 代 码 如 下 所 示 : 


<?xml Version="1.0"” encoding="utf-8" ?> 
< 公交 车 > 
< 车 95> 
< 长 >4m</ 长 > 
< 宽 >3m</ 宽 > 
< 数量 >40 人 </ 数 量 > 
</ 车 95> 
< 车 K6> 
< 长 >4m</ 长 > 
< 宽 >3m</ 宽 > 
< 数量 >20 人 </ 数 量 > 
</ 车 K6> 
</ 公 交 车 > 


在 XML 文档 中 ， 使 用 属性 和 子 元素 均 可 以 描述 数据 信息 ， 只 是 根据 执行 环境 和 自己 的 喜 


好 来 决定 使 用 哪 种 方式 而 已 。 在 文档 中 使 用 属性 ， 有 以 下 缺陷 ， 


因 


@ 属性 不 容易 扩展 。 

@ 属性 不 能 描述 文档 结构 。 

@ ”属性 很 难 被 程序 代码 处 理 。 

@ ”属性 值 很 难 通过 DTD 进行 测试 。 

综合 以 上 几 点 来 看 ， 在 文档 中 使 用 属性 还 是 有 很 大 的 局 限 性 。 由 于 XML 的 可 扩展 性 高 ， 
此 数据 在 XML 中 需要 经 常 添加 或 者 修改 ， 如 果 将 这 些 数据 放 入 属性 中 存储 ， 那 么 很 容易 想 


象 ， 这 将 会 对 数据 的 维护 和 更 新 造成 多 大 的 麻烦 。 


名 


3.4 ”展示 个 性 的 名 言 警 句 


我 们 在 使 用 NET 做 网 站 或 者 系统 时 ， 定 义 了 很 多 相同 的 属性 ， 但 是 程序 在 编译 的 时 候 却 


能 准确 无 误 地 执行 ， 为 什么 ? 这 是 因为 这 些 相同 的 属性 有 不 同 的 命名 空间 ， 正 是 声明 了 这 些 命 


He 


空间 ， 才 能 使 程序 调用 这 些 属性 时 不 发 生 混乱 。 那 么 ， 在 XML 文档 中 同样 存在 命名 空间 这 


< 


层 含义 。 下 面 我 们 来 看 一 下 XML 文档 中 的 命名 空间 。 
cc 视频 教学 : 光盘 /videos/03/XML 命名 空间 .avi 加 长度 : 9 分 钟 


3.4.1 基础 知识 一 一 XML 命名 空间 


由 于 XML 允许 用 户 根据 需要 自 定义 标记 ， 因 此 不 可 避免 地 会 产生 相同 的 标记 。 当 解析 器 
遇 到 相同 的 标记 时 就 会 产生 混乱 。 而 此 时 的 XML 命名 空间 正 是 解决 这 些 混乱 的 关键 , XML 命 
名 空间 是 XML 文档 中 所 使 用 元 素 或 属性 名 称 的 集合 ， 它 在 元 素 或 者 属性 名 称 上 加 以 限定 ， 避 
免 名 称 相同 的 元 素 或 者 属性 发 生 冲 突 。 

命名 空间 通常 由 统一 资源 标识 符 (Uniform Resource Identifier，URD 确 定 ， 在 XML 文档 中 
作为 元 素 类 型 或 者 属性 名 称 使 用 。 另 外 统一 资源 定位 符 (Uniform Resource Locator，URIL)、 统 
一 资源 名 称 (Uniform Resource Name,，URN)、 全 局 唯一 标识 符 (Uniform Unique Identifier, UUID) 
和 全 球 唯 一 标识 符 (Globally Unique Identifier，GUID) 等 均 可 以 作为 命名 空间 来 使 用 。 

既然 XML 命名 空间 有 如 此 大 的 作用 ， 那 么 下 面 我 们 就 来 看 一 下 如 何 声明 命名 空间 。 


1. XML 中 命名 空间 的 声明 


XML 命名 空间 是 由 前 级 和 本 地 部 分 组 成 的 ， 中 间 用 冒号 “:” 隔 开 ， 前 组 标识 元 素 或 属性 
所 在 的 名 称 空间 ， 本 地 部 分 标识 名 称 空间 中 的 某 个 元 素 或 属性 。XML 命名 空间 的 声明 语法 格 
式 如 下 所 示 : 


xmlns:prefix="URI" 


上 述 语法 中 各 参数 的 含义 如 下 所 示 。 

@ xmlns: 必需 的 属性 。 

@ prefix: 命名 空间 的 别名 ， 它 的 值 不 能 为 xml。 

@ URI: 用 来 标识 抽象 资源 ， 按 照 URI 规范， 有 两 种 常规 类 型 的 URI 分 别 是 : 统一 资源 
定位 符 URL、 统一 资源 名 称 URN。 这 两 种 类 型 的 URI 都 可 以 确保 命名 空间 的 唯一 性 。 

下 面 我 们 通过 一 个 例子 来 说 明 如 何 声 明和 使 用 命名 空间 ， 代 码 如 下 所 示 : 


<?xml version="]1.0" encoding="utf-8" ?> 


<goods xmlns:info="http://www.qxian.com/SkinCare" 
xmlns:shapoo="urn:qxian.shampoo"> 
<info.SkinCare> 
<info.anti wrinkle> 
<info.SkinName> 欧 莱 雅 </info.skinName> 
<info.SkinPrice>450 元 </info.SkinPrice> 
<info.SkinEffect> 去 干 纹 </info.SkinEffect> 
</info.anti wrinkle> 
</info.SkinCare> 
<shapoo .shampoo> 
<shapoo -repair > 
<shapoo .shampooName> 拉 芳 </shapoo.shampooName> 
<shapoo .shampooPrice>50 元 </shapoo .shampooPrice> 
<shapoo .shampooEffect> 修 复 干枯 洗 发 露 </shapoo .shampooEffect> 


之 da 
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</shapoo -repair> 

<shapoo .Prevent> 
<shapoo.shampooName> 迪 彩 </shapoo. shampooName> 
<shapoo .shampoopPrice>30 元 </shapoo. shampooPrice> 
<shapoo .shampooEffect> 防 干枯 洗 发 圳 </shapoo.shampooEffect> 

</shapoo.Prevent> 

</shapoo.shampoo> 
</goods> 


在 上 述 代码 中 , 我们 声明 了 两 个 命名 空间 info 和 shapoo, 并 且 虚 拟 了 两 个 命名 空间 的 URI。 
此 命名 空间 中 的 元 素 或 者 属性 名 称 需要 使 用 “命名 空间 ”来 引用 命名 空间 中 的 子 元 素 。 在 info 
命名 空间 中 ， 描 述 了 两 个 子 元 素 SkinCare 和 anti_wrinkle; 而 在 shapoo 命名 空间 中 ， 描 述 了 两 
个 子 元 素 repair 和 Prevent。 由 于 解析 器 不 对 URI 进行 访问 ， 因 此 对 XML 文档 的 运行 结果 没有 
影响 。 

程序 运行 的 结果 如 图 3-2 所 示 。 


vx 


EE 


图 3-2 使 用 两 个 命名 空间 的 效果 
另外 ， 在 XML 文档 中 还 有 一 个 空间 被 称 为 默认 命名 空间 。 所 谓 默认 命名 空间 是 说 没有 为 
命名 空间 定义 别名 ， 格 式 如 下 所 示 : 


xmlns="URI" 


下 面 我 们 来 看 一 个 默认 命名 空间 的 例子 ， 代 码 如 下 所 示 : 


<?xml] version="1.0" encoding="utf-8" ?> 

<weather xmlns="http://www.weather/weather"> 
<direction> 微 风 </direction> 
<temper>15 度 </temper> 
<state> 晴 转 多 云 </state> 

</weather> 


在 上 述 文档 中 ， 我 们 定义 了 一 个 天 气 根 元 素 weather， 并 且 声 明了 一 个 默认 的 命名 空间 ， 


< 


而 在 此 元 素 下 的 direction、temper 和 state 属性 都 是 引用 这 个 命名 空间 。 


因为 XML 文档 中 只 能 定义 一 个 根 元 素 ， 在 根 元 素 中 声明 了 一 个 命名 空间 ， 说 明 此 元 素 以 


及 在 其 内 部 的 子 元 素 均 可 以 使 用 此 命名 空间 。 但 是 如 果 我 们 在 子 元 素 中 重新 声明 一 个 命名 空 
间 ， 那 么 在 其 子 元 素 中 的 属性 如 何 引 用 命名 空间 呢 ， 这 就 需要 我 们 了 解 命名 空间 的 范围 了 。 下 
面 来 讲解 一 下 命名 空间 的 范围 。 


2. 命名 空间 的 范围 


和 其 他 编程 语言 中 的 命名 空间 相似 ， 命 名 空间 都 有 其 作用 范围 。 在 XML 文档 中 ， 命 名 空 


间 都 是 在 某 个 元 素 内 声明 的 ， 那 么 它 的 作用 范围 就 是 该 元 素 。 因 此 该 元 素 以 及 所 有 子 元 素 和 属 
性 均 可 以 引用 这 个 命名 空间 , 而 不 属于 该 元 素 范围 之 内 的 子 元 素 或 者 属性 则 需要 重新 声明 此 命 
名 空间 方 可 引用 。 


下 面 我 们 来 看 一 个 例子 ， 代 码 如 下 所 示 : 


<?xml] version="1.0" encoding="utf-8" ?> 
<lvyou xmlns:lvyouSs="urn:lvyou.lvyou"> 
<lvyous .spring> 
<lvyouSs .name> 国 际 椰子 节 </lvyous .name> 
<lvyouSs . site> 海 南 省 海口 市 、 文 昌 县 、 通 什 市 </1vyouSs . site> 
<lvyouSs .attractions> 举 办 椰 城 灯会 、 椰 子 一 条 街 、 黎 族 苗 族 联 欢 节 、 国 际 龙 舟 赛 民族 武术 播 
台 赛 。 文 体 表演 、 黎 族 苗 族 婚礼 、 系 祖 </lvyous .attractions> 
</lvyous .spring> 
<summer xmlns:summerS="http://www.lvyou/summer"> 
<summerS .name> 九 寨 沟 </summers .name> 
<summerS .site> 九 寨 沟 </summers.site> 
<summerS .attractions> 九 寨 沟 以 绝 天 下 的 原始 、 神 秘 而 闻名 。</summerS .attractions> 
</summer> 
<lvyouSs .autumn> 
<lvyouSs .name> 阳 光 灿 烂 海南 游 </1vyous .name> 
<lvyouSs .site> 阳 光 灿 烂 海南 游 </lvyous .site> 
<lvyouS .attractions> 海 南 气候 宜人 ， 冬 可 避 寒 ， 且 自然 风光 优美 ， 海 湾 波 平 浪 静 ， 柔 软 的 沙 
滩 洁白 如 银 </1vyous .attractions> 
</lvyous .autumn> 
</lvyou> 


在 上 述 文档 中 ， 我 们 在 根 元 素 lvyou 内 声明 了 一 个 命名 空间 lvyouS， 那 么 在 此 元 素 下 的 子 


元 素 spring、summer、autumn 均 可 引用 此 命名 空间 lvyouS。 但 是 在 子 元 素 summer 内 部 重新 声 
明了 一 个 命名 空间 summerS， 那 么 在 子 元 素 saummer 下 的 属性 name、site、attractions 则 属于 
summers 命名 空间 。 而 其 他 的 子 元 素 或 者 属性 不 属于 summerS， 因 而 不 能 引用 此 命名 空间 。 


3.4.2 ”实例 描述 


可 顾 以 往 ， 感 慨 颇 多 ， 但 是 时 代 的 竞争 与 发 展 由 不 得 我 们 沉 洒 过 去 ， 唯 一 能 做 的 就 是 好 好 


把 握 今 天 ， 以 便 能 使 未 来 的 生活 更 加 充实 、 精 彩 。 


mfZ) >> 
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为 此 , 我 使 用 XML 文档 中 的 命名 空间 把 对 昨天 、 今 天 和 明天 的 生活 慨叹 用 诗句 记录 下 来 ， 
以 便 时 刻 提醒 自己 不 要 造成 “少壮 不 努力 ， 老 大 徒 伤 悲 ”的 局 面 。 


3.4.3 ”实例 应 用 


【 例 3-2】 展示 个 性 的 名 言 警句 
(1) 创建 名 称 为 fature.xml 的 文件 。 
(2) 在 血 ture.xml 中 添加 如 下 代码 : 


<?xml version="]1.0" encoding="utf-8" ?> 
<time xmlns="http://www.myTime/mytime"> 
<yesterday xmlns:myyesterday="http://www.myTime/myyesterday"> 
<myyesterday. name> 金 缕 衣 </myyesterday -name> 
<myyesterday. author> 杜 秋 娘 </myyesterday -author> 
<myyesterday.shij u> 劝 君 须 惜 少年 时 。 
劝 君 莫 惜 金 缕 衣 ， 
有 花 堪 折 直 须 折 ， 
葛 待 无 花 空 折 枝 。</myyesterday.shiju> 
</yesterday> 
<today xmlns:mytoday="http://www.myTime/mytoday"> 
<mytoday .name> 明 日 歌 </mytoday .name> 
<mytoday.author> 钱 稚 滩 </mytoday.author> 
<mytoday.shiju> 明 日 复明 日 ， 
明日 何其 多 。 
我 生 待 明日 ， 
万 事 成 践 跷 。 
世人 苦 被 明日 累 ， 
春 去 秋 来 老将 至 。 
朝 看 水 东 流 ， 
暮 看 日 西 险 。 
百年 明日 能 几何 ? 
请 君 听 我 明日 歌 !</mytoday.shiju> 
</today> 
<tomorrow xmlns="http://www.myTime/mytomorrow"> 
<name> 英 </name> 
<author> 泰 戈 尔 </author> 
<shiju> 生 如 夏 花 之 绚烂 ， 死 如 秋 叶 之 静 美 </shiju> 
</tomorrow> 
</time> 


(3) 保存 修改 好 的 代码 。 


3.4.4 ”运行 结果 


运行 程序 ， 执 行 的 结果 如 图 3-3 所 示 。 


< 人 


@ 服务 开发 学 习 实录 .… 


阐 |s x 
全" 目 - 口 堆 - WH- 2 加- IRO- 内 “”| 


万 生成 攻防 。 雇 人 贡 汪 明日 轩 ， 


生 竺 明日， 万 玫 
六 和 


ttp:/ fw myTime /mytomorrow"> 


花 之 振 侨 。 死 如 和 对 之 酌 美 -chj- 


3-3，” 谋 套 命名 空间 的 效果 


3.4.5 ”实例 分 析 


En 


在 该 文档 中 ， 我们 定义 了 一 个 根 元 素 ， 并 在 根 元 素 内 上 声明 了 一 个 默认 的 命名 空间 。 那 么 在 
此 根 元 素 下 的 子 元 素 以 及 属性 都 属于 这 个 上 默认 的 命名 空间 。 在 子 元 素 yesterday 和 today 中 分 别 
声明 了 命名 空间 myyesterday 和 mytoday。 

接着 在 子 元 素 tomorrow 中 声明 了 一 个 默认 的 命名 空间 ， 那 么 在 该 子 元 素 下 的 属性 即 属于 
该 默认 的 命名 空间 。 


3.5 歌词 秀 


我 喜欢 听 音 乐 ， 并 且 热衷 于 LRC 歌词 ， 由 于 LRC 歌词 上 有 时 间 说 明 ， 对 于 我 这 个 丝毫 不 
懂 音 律 的 人 来 说 有 很 大 的 帮助 。 俗 话说 ， 没 有 最 好 ， 只 有 更 好 ， 我 一 直 想 要 设计 出 带 自己 特色 
的 歌词 模式 。 而 恰巧 这 一 节 讲 的 是 实体 引用 和 CDATA 区 ， 因 此 我 想 从 这 里 得 到 一 些 灵感 ， 我 
人 迫不及待 地 想来 看 一 下 。 


= 视频 教学 : 光盘 /videos/03/ 歌 词 秀 .avi @@ 长 度 : 7 分 钟 
3.5.1 基础 知识 一 一 字符 和 实体 引用 
字符 和 实体 引用 是 指 可 以 向 XML 文档 中 引入 其 他 信息 ， 而 不 需要 在 文档 中 输入 。 例 如 在 


XML 文档 中 会 遇 到 大 于 号 “> 之 ”、 小 于 号 “<” 以 及 连接 符号 “多 ”等 ， 如 果 你 想 要 将 这 些 
字符 在 XML 文档 中 显示 出 来 ， 那 么 就 要 考虑 实体 引用 了 。 


El >> 
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实体 引用 是 以 “&” 开 始 ， 以 “;” 结 尾 的 引用 。 


实体 引用 的 作用 就 是 ， 当 字符 或 数据 中 需要 使 用 到 这 些 特殊 符号 时 ,可 以 采用 它 的 实体 引 
用 来 代替 。 下 面 我 们 来 看 一 下 哪些 特殊 符号 可 以 使 用 实体 引用 ， 如 表 3-1 所 示 。 
表 3-1 XML 的 实体 引用 


实体 引用 含 义 
&lt: 小 于 号 
&et: 大 于 号 
&amp; 连接 符 
Rapos: 单 引 号 
&quot: 双 引 号 


看 了 表 3-1 中 XML 的 实体 引用 ， 是 不 是 感觉 很 不 可 思议 ， 下 面 我 们 通过 一 个 例子 来 说 明 
一 下 。 代 码 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8" ?> 
< 生活 > 
< 名 称 > 
&1t; 老 男孩 ggt; 
</ 名 称 > 
< 样 貌 > 
&apos; 生 活 像 一 把 无 情 刻 刀 ，&apos; &amp; 
&quot; 改 变 了 我 们 模样 Equot; 
</ 样 瑶 > 
</ 生 活 > 


在 上 述 文档 中 ,我 们 使 用 了 &lt 、&gt、&amp:、&apos:、&quot 等 字符 ， 那 么 程序 运行 时 ， 
解析 器 会 将 这 些 特殊 字符 解析 成 “<”、“>”、“&”、“，”、““»”»”。 下 面 我 们 来 看 一 
下 运行 的 结果 ， 是 否 与 我 们 推测 的 一 致 ， 如 图 3-4 所 示 。 

nts and Settings\Adainistrator\ 梨 面 \ 其 他 \xH. .. 攻关 | 必 


本 CDocaments and Settings\Adninistrator\ 硕 面 \ 其 她 VL xnl | $7 XX 


宽 收 藏 天。 蔬 c Docmmts md Se 伪 - 轩 -已 唤 - 下- 


<zxml version="1.0" encoding="utf-8" ?> 


- < 生活 > 
< 名 称 >< 老 男孩 ></ 名 称 > 
< 样 锅 > 生活 像 一 把 无 情 刻 刀 ，' & "改变 了 我 们 模样 "</ 样 论 > 
< 生活 > 


图 3-4 采用 实体 引用 代 蔡 的 效果 


3.5.2 ”基础 知识 一 一 CDATA 的 使 用 


上 面 的 字符 和 实体 引用 挺 容易 理解 的 ， 但 是 这 个 CDATA 看 上 去 挺 难 的 ， 都 有 点 胆 愤 了 。 


< 


但 不 是 有 这 样 一 句 话 吗 ，“ 世 上 所 有 的 问题 ， 就 怕 认 真 二 字 ”， 那 么 这 次 就 让 我 们 认真 对 待 看 
上 去 挺 难 理解 的 CDATA 区 吧 ! 

CDATA 区 是 用 来 包含 文本 的 方法 ， 通 常用 于 建立 代码 的 脚本 ， 例 如 : JavaScript 脚本 。 放 
在 CDATA 区 的 内 容 会 被 XML 解析 器 忽略 ,然后 将 会 被 XML 处 理 程序 当 作 字 符 数据 来 处 理 。 
下 面 我 们 来 看 一 下 使 用 CDATA 的 语法 格式 ， 如 下 所 示 : 

<![CDATA[content]]> 

了 解 了 CDATA 的 语法 格式 ， 我 们 通过 一 个 小 例子 来 加 深 理 解 ， 代 码 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8" ?> 


<company> 
<employee> 
<name>dcy</name> 
<department>.NET 编程 </department> 
<position> 公 司 小 员工 </position> 
<hobby> 看 电视 </hobby> 
<hate> 自 私自 利 </hate> 
</employee> 
</company> 


运行 程序 ， 执 行 的 结果 如 图 3-5 所 示 。 


C:\Documents and Settings\Adeainistrator\ 捍 面 \NoCdata. zal 司 器 | 园 


国 CVoments and SettingrWdainistrator\ 硕 面 VioCtate ml 


请 中 本 天 。 节 c: Docments and se 芥 - 园 - 马 咒 -本 吕 - 


<?xml version="1.0" encoding="utf-8" ?> 
- <company> 
- <employee> 
<name>dcy </name> 
<dspartment>-NET 思 程 /department> 
<position> 公 司 小 员工 </position> 
<hobby> 看 电视 </hcbby> 
<hate> 自 私自 利 </hate> 
</employee> 
</company> 


3-5 正常 情况 下 显示 的 效果 


在 图 3-5 中 ， 如 果 我 不 想 让 XML 解析 器 解析 子 元 素 中 的 属性 hobby 和 hate， 那 么 最 理想 
的 做 法 就 是 将 这 两 个 属性 放 到 CDATA 区 中 ， 代 码 如 下 所 示 : 


<?xml] Version="1.0"” encoding="utf-8" ?> 


<company> 

<employee> 
<name>dcy</name> 
<department >.NET 编程 </department > 
<position> 公 司 小 员工 </position> 
<! [CDATAI 
< hobby > 看 电视 </ hobby > 
<hate> 自 私自 利 </hate> 
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hE 
</employee> 
</company> 


保存 修改 好 的 代码 。 运 行程 序 ， 得 到 的 结果 如 图 3-6 所 示 。 


oxml version="1.0" encoding="utf-8" ?> 


- <company> 
- <employee> 
<name>dcy</name> 
<department>-NET 护 程 </department> 
<position> 公 司 小 员工 </position> 


~ <![CDATA[ 
<hobby> 看 电视 </hobby> 
<hace> 自 私自 利 </hace> 
> 
</employee> 
</company> 


3-6 使 用 CDATA 区 的 效果 


在 上 面 我 们 提 到 XML 处 理 程序 时 会 将 CDATA 区 中 的 文本 内 容 作为 字符 数据 来 处 理 ， 因 
此 当 文 本 文档 大 量 地 使 用 特殊 符号 时 ， 我 们 就 可 以 编写 如 下 代码 : 
<?xml version="1.0" encoding="utf-8" ?> 
< 歌词 > 
<![CDRATRT[ 
< 名 称 > 
< 爱 的 供养 > 
</ 名 称 > 
< 语句 > 
"我 用 尽 一 生 一 世 来 将 你 供养 ， 只 盼望 能 停 住 你 流转 的 目光 ，' & 
"请 赐予 我 无 限 爱 与 被 爱 的 力量 ， 让 我 能 安心 在 车 提 下 静 静 的 观 想 " 
</ 语 句 > 
六 
</ 歌 词 > 


瞧 ， 这 样 是 不 是 比 那些 通 篇 文档 都 用 实体 引用 代 蔡 简便 多 了 。 


3.5.3 ”实例 描述 


最 近 ， 我 迷 上 了 一 首 歌 ， 名 字 是 “一 剪 梅 ”， 记 得 曾经 有 人 说 过 : 我 们 之 所 以 留恋 某 个 地 
方 都 是 因为 我 们 留恋 那个 地 方 的 人 。 那么 我 们 喜欢 上 一 首 歌 也 是 因为 我 们 被 电视 剧 里 面 的 情节 
所 打动 。 为 了 留 住 这 感动 的 时 刻 ， 我 想 用 所 学 的 XML 字符 和 实体 引用 以 及 CDATA 的 知识 将 
这 首 歌 的 歌词 ， 以 自己 的 方式 展示 出 来 。 

下 面 来 看 我 的 实现 方案 。 


< 


3.5.4 ”实例 应 用 


【 例 3-3】 歌词 秀 


(1) 创 妈 


一 个 名 称 为 song.xml 的 文件 。 


(2) 在 song.xml 文件 中 添加 如 下 代码 : 


<?xml version="1.0" encoding="utf-8" ?> 


<geci> 
<quming> 一 前 梅 </quming> 
<yuju> 
&lt;00:03.00&gt; 一 前 梅 

</yuju> 

<! [CDATAI 


<00: 
<00: 
<00: 
<00: 
<00: 
<00: 
<01: 
< 
<OLs 


]]> 


</geci> 


(3) 保存 修改 好 的 代码 。 


3.5.5 


= >> 


2 
34. 
41. 
48. 
53. 
54. 
.66> 冷 冷 冰 雪 不 能 掩 没 

.44> 就 在 最 冷 枝 头 绽放 
.78> 看 见 春天 走向 你 我 


84> 真 情 像 草原 广阔 
06> 层 层 风雨 不 能 阻隔 
15> 总 有 云 开 日 出 时 候 
46> 万 丈 阳 光照 亮 你 我 
28> 

80> 真 情 像 梅花 开 遍 


运行 结果 


执行 程序 ， 显 示 的 效果 如 图 3-7 所 示 。 


下 WebTnavavae =nl 


J Lx 


< 梅 </q 
<yuju><00:03.00> 一 荣 梅 </yuju> 
- <I[CDATAL 


3-7 ”歌词 显示 的 效果 


局 
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3.5.6 ”实例 分 析 


Ba 


在 本 实例 中 ， 我 们 使 用 了 字符 和 实体 引用 ， 从 而 在 文档 中 将 那些 特殊 的 符号 显示 出 来 。 另 
外 也 使 用 CDATA 使 歌词 的 内 容 不 被 XML 解析 器 解析 。 
这 样 看 来 CDATA 的 使 用 是 不 是 很 简单 啊 。 


3.6 ”制作 精彩 的 树 状 后 台 


当 我 们 打开 一 张 网 页 ， 映 入 眼帘 的 不 仅仅 是 绚丽 多 姿 的 画面 ， 还 有 丰富 多 彩 的 内 容 。 这 些 
内 容 我 们 难道 要 从 数据 库 中 一 条 条 地 插入 进去 吗 ? 当然 不 是 ， 目 前 无 论 大 小 网 站 或 者 系统 ， 开 
发 者 都 会 将 它们 分 为 前 台 和 后 台 两 部 分 。 前 台 为 客户 提供 数据 库 中 内 容 的 展示 ， 而 后 台 为 该 网 
站 或 者 系统 的 管理 员 提供 增 、 删 、 改 、 查 等 功能 。 

一 般 后 台 的 展示 都 是 以 树 状 的 形式 展现 的 , 实现 此 效果 有 很 多 方式 , 在 这 里 我 们 使 用 DTD 
的 方式 来 展示 一 下 。 


9 
加 视频 教学 : 光盘 /videos/03/DTD.avi 人 @@ 长 度 :27 分钟 


3.6.1 基础 知识 一 一 文档 类 型 定义 DTD 


如 果 想 要 创建 有 效 的 XML 文档 ， 不 仅 需 要 语法 正确 而 且 规范 ， 还 需要 遵循 一 定 的 结构 规 
范 。 而 文档 类 型 定义 DID 恰 为 XML 文档 的 结构 规范 提供 了 一 组 规则 约束 。 下 面 我 们 来 介绍 
何 为 文档 类 型 定义 DTD。 

文档 类 型 定义 (Document Type Definition，DTD)， 是 使 用 文档 类 型 声明 来 引入 XML 文档 
中 的 。 它 列 出 了 可 用 在 文档 中 的 元 素 、 属 性 和 实体 等 以 及 这 些 内 容 的 相互 之 间 的 关系 ， 另 外 此 
DTD 文档 中 还 包含 元 素 的 定义 规则 ， 元 素 间 关系 的 定义 规则 ， 元 素 可 使 用 的 属性 以 及 可 使 用 
的 实体 或 符号 规则 。 

目前 ， 有 很 多 定义 好 的 DTD 文件 可 供 我 们 直接 使 用 , 这 些 写 好 的 DTD 文件 已 经 根据 不 同 
的 行业 和 应 用 建立 了 通用 的 元 素 和 标签 规则 。 使 用 时 ， 不 需要 我 们 自己 重新 创建 ， 只 需 在 它们 
的 基础 上 加 入 所 需要 的 新 标识 即 可 。 当然 , 我 们 也 可 以 创建 自己 的 DTD 文件 , 以 便 能 够 与 XML 
文档 配合 得 天 衣 无 颖 。 

下 面 我 们 就 来 看 一 下 如 何 创建 DID 文档 。 


1. 内 部 DTD 


看 到 “内 部 ”DTD 和 “外 部 ”DTD， 你 有 没有 想到 在 HTML 文档 中 的 “内 部 ”样式 和 “外 
部 ”样式 呢 ? 没 错 ， 道 理 都 是 一 样 的 。DTD 可 以 在 XML 文档 中 直接 写 入 ， 也 可 以 形成 单独 的 
文件 ， 因 此 将 DTD 分 为 内 部 DID 和 外 部 DID 两 种 类 型 。 而 这 两 种 类 型 的 差别 在 于 : 内 部 定 


< 


义 好 的 DTD 只 能 在 此 XML 文档 中 使 用 ， 外 部 编辑 好 的 DTD 则 可 以 被 不 同 的 XML 文档 共享 
和 调用 。 

下 面 我 们 先 来 介绍 内 部 DTD。 

内 部 DTD 被 称 为 DTD 的 内 部 子 集 ， 在 XML 文档 中 直接 定义 ， 规 则 是 以 “<!IDOCTYPE” 

开始 ， 以 “]>” 结 束 ， 其 语法 格式 如 下 所 示 。 

<!DocTYPE 根 元 素 [ 

<!ELEMENT 根 元 素 ( 子 元 素 列表 ) > 
<!ELEMENT 子 元 素 名 称 EMPTY/ANY/#PCDTAT/ ( 子 元 素 内 容 ) / ( 混 含 内 容 ) > 
<!RTTLIST 元 素 名 属性 名 属性 类 型 属性 默认 值 > 

]> 

在 上 述 语 法 中 ， 参 数 说 明 如 下 所 示 。 

@ <!IDOCTYPE: 关键 字 ， 表 示 定 义 DTD， 且 必须 为 大 写 。 

@ <!IELEMENT: 定义 文档 构成 的 元 素 。 首 先 ， 需 要 声明 根 元 素 及 其 包含 的 所 有 子 元 素 。 
如 果 文 档 根 元 素 下 有 很 多 子 元 素 ， 那 么 就 需要 多 个 <!IELEMENT 定义 ， 而 EMPTY / 
ANY/ #PCDTAT / ( 子 元 素 内 容 )/ ( 混 含 内 容 ) 等 为 元 素 的 内 容 类 型 ， 每 一 个 子 元 素 对 应 
一 种 元 素 的 内 容 类 型 。 

@ ”<!IATTLIST: 定义 文档 中 的 根 元 素 或 者 子 元 素 的 属性 。 

@ ]>: 定义 结束 DTD。 

下 面 通过 一 个 示例 来 说 明 一 下 内 部 DTD 的 使 用 ， 代 码 如 下 所 示 。 

< 博客 博客 ID="dcy123"> 

< 文章 文章 ID="dcyandly12"> 私 密 日 记 </ 文 章 > 
< 时 间 >2011-2-25</ 时 间 > 
< 标题 > 那 被 逼 出 来 的 成 熟 </ 标 题 > 
< 内 容 > 
哑 的 时 候 没 人 哄 ， 我 学 会 了 坚强 ， 
怕 的 时 候 没 人 陪 ， 我 学 会 了 勇敢 ; 
烦 的 时 候 没 人 问 ， 我 学 会 了 承受 ; 
累 的 时 候 没 人 可 以 依靠 ， 我 学 会 了 自立 …… 
就 这 样 我 找到 了 自己 ， 
</ 内 容 > 
</ 博 客 > 


上 面 的 这 段 代 码 是 没有 定义 DID 的 ， 运 行程 序 的 结 


果 如 图 3-8 所 示 。 


3-8 未 定义 DTD 的 效果 
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修改 代码 ， 在 文档 内 部 定义 DID， 代 码 如 下 所 示 : 


<?xml Version="1.0"” encoding="utf-8" standalone="yes" ?> 
<!DOCTYPE 博客 [ 
<!ELEMENT 博客 (文章 , 时间, 标题 ,内容 ) > 
<!RTTLIST 博客 博客 ID ID #REQUIRED> 
<!ELEMENT 文章 (#PCDATA)> 
<!RTTLIST 文章 文章 ID ID #REQUIRED> 
<!ELEMENT 时 间 (#PCDRTR) > 
<!ELEMENT 标题 (#PCDRTR) > 
<!ELEMENT 内 容 (#PCDRTR) > 
EE 
< 博客 博客 ID="dcy123"> 
< 文章 文章 ID="dcyandly12"> 私 密 日 记 </ 文 章 > 
< 时 间 >2011-2-25</ 时 间 > 
< 标题 > 那 被 逼 出 来 的 成 熟 </ 标 题 > 
< 内 容 > 
峰 的 时 候 没 人 哄 ， 我 学 会 了 坚强 ; 
怕 的 时 候 没 和 人 陪 ， 我 学 会 了 勇敢 ; 
烦 的 时 候 没 人 问 ， 我 学 会 了 承受 ; 
累 的 时 候 没 人 可 以 依靠 ,我 学 会 了 自立 …… 
就 这 样 我 找到 了 自己 ， 
</ 内 容 > 
</ 博 客 > 


运行 ， 效 果 如 图 3-9 所 示 。 


人 
tC rs 


乓 时 术 人 癌 和 当时 术 人 可 避 代 委 ， 和 人生 了 各 
六 芯 这 全 交 校本 了 自己 ,， 
> 


3-9 在 文档 内 部 定义 的 DTD 效果 


通过 图 3-8 和 图 3-9 可 以 看 出 ， 运 行 结果 显示 的 “<!DOCTYPE 博客 (View Source for full 
doctype.…)>” 指 定 了 文档 类 型 的 声明 。 
2. 外 部 DTD 


上 面 我 们 介绍 了 在 文档 内 部 定义 DTD， 接 着 来 看 在 外 部 是 如 何 定义 DTD 的 。 

所 谓 外 部 DTD， 又 被 称 为 DTD 的 外 部 子 集 ， 即 是 指 在 XML 文档 外 单独 定义 DTD， 并 通 
过 外 部 的 URL 将 DTD 文件 引入 XML 文档 中 。 在 外 部 编写 的 DID 文件 ， 扩 展 名 是 .dtd。 虽 然 
外 部 DID 具有 独立 性 的 特征 ， 可 以 提供 给 多 个 XML 文档 使 用 ， 但 是 其 定义 结构 必须 与 文档 
中 的 元 素 对 应 ， 否 则 没有 任何 效果 。 

外 部 DID 与 内 部 DTD 在 XML 文档 中 放置 的 位 置 相同 ， 有 两 种 语法 格式 ， 如 下 所 示 : 


<@— 


<!DOCTYPE 根 元 素 名 SYSTEM "DTD-URL"> 
或 者 
<!DOCTYPE 根 元 素 名 PUBLIC "DTD-NAME" "DTD-URL"> 


其 参数 说 明 如 下 。 

@ <!DOCTYPE: 关键 字 ， 文 档 类 型 声明 表示 包含 或 引入 DTD。 

@ SYSTEM: 关键 字 ， 指 的 是 该 外 部 DTD 文件 是 私有 的 。 

@ ”PUBLIC: 关键 字 ， 指 的 是 该 外 部 DTD 文件 是 共有 的 , 而 “DTD-NAME” 是 DTD 中 
的 一 个 逻辑 名 称 。 

@ DTD-URL: 通过 URL 将 外 部 DTD 文件 引入 XML 文档 中 。 

我 们 来 看 一 个 小 例子 。 首先, 创建 一 个 名 称 为 waiXMLDTD.dtd 的 文件 ， 并 添加 如 下 代码 : 


<?xml] version="1.0" encoding="utf-8" ?> 
<!ELEMENT 博客 (文章 , 时间, 标题 , 内 容 ) > 
<!RTTLIST 博客 博客 ID ID #REQUIRED> 
<!ELEMENT 文章 (#PCDRTR) > 

<!RTTLIST 文章 文章 ID ID #REQUIRED> 
<!ELEMENT 时 间 (#PCDRATR) > 

<!ELEMENT 标题 (#PCDATA)> 

<!ELEMENT 内 容 (#PCDATA)> 


接着 ， 创 建 一 个 名 称 为 waiXML.xml 的 文件 ， 并 添加 如 下 代码 : 


<?xml] Version="1.0"” encoding="utf-8" standalone="no"?> 
<!DOCTYPE 博客 SYSTEM "waixMLDTD.dtd"> 
< 博客 博客 ID="dcy123"> 
< 文章 文章 ID="dcyandly12"> 私 密 日 记 </ 文 章 > 
< 时 间 >2011-2-25</ 时 间 > 
< 标题 > 那 被 逼 出 来 的 成 熟 </ 标 题 > 
< 内 容 > 哭 的 时 候 没 人 哄 ， 我 学 会 了 坚强 ; 
怕 的 时 候 没 和 人 陪 ， 我 学 会 了 勇敢 ; 
烦 的 时 候 没 人 问 ， 我 学 会 了 承受 ; 
累 的 时 候 没 人 可 以 依靠 ， 我 学 会 了 自立 …… 
就 这 样 我 找到 了 自己 ，</ 内 容 > 
</ 博 客 > 


保存 代码 。 
运行 程序 的 效果 如 图 3-10 所 示 。 


图 3-10 引入 外 部 DTD 的 效果 
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通过 图 3-9 和 图 3-10 的 对 比 ， 可 以 看 出 在 内 部 定义 DTD 和 使 用 URL 引入 外 部 DTD 的 效 
果 是 一 样 的 。 

3. DTD 对 元 素 和 属性 的 声明 

通过 上 一 节 的 介绍 ， 我 们 了 解 了 如 何在 文档 内 部 定义 DTD 和 编写 外 部 DTD 文件 ， 其 中 
DTD 描述 了 XML 文档 中 元 素 之 间 的 结构 关系 。 那 么 这 一 节 就 来 看 看 DID 中 元 素 和 属性 的 声 
明 。 首 先 来 看 DTD 对 元 素 的 声明 。 

元 素 是 XML 文档 中 必 不 可 少 的 构件 ， 它 展示 了 XML 文档 的 结构 及 特性 。 在 DTD 中 使 用 
元 素 类 型 来 声明 XML 文档 中 的 所 有 元 素 。 元 素 类 型 名 称 不 但 可 以 给 出 元 素 的 名 称 ， 而 且 还 定 
义 了 元 素 的 具体 类 型 。 元 素 类 型 的 声明 由 ELEMENT 关键 字 来 定义 ， 其 语法 格式 如 下 所 示 : 

<!ELEMENT 元 素 名 称 EMPTY/ANY/#PCDTAT/ ( 子 元 素 内 容 ) / ( 混 含 内 容 ) > 

在 此 语法 中 ， 元素 名 称 后 面 是 元 素 内 容 类 型 。 元 素 内 容 类 型 指定 了 元 素 要 包含 的 数据 内 容 
格式 ， 分 别 是 EMPTY( 空 )、ANY( 任 意 )、#PCDATA、 子 元 素 型 和 混合 型 5 种 类 型 。 下 面 将 对 
这 5 种 类 型 一 一 介绍 。 

(1) 关键 字 EMPTY 用 于 声明 空 元 素 。 其 用 法 是 只 能 包含 属性 ， 而 不 能 包含 数据 内 容 或 子 
元 素 。 语 法 格式 如 下 所 示 : 

<!ELEMENT 元 素 名 EMPTY> 

例如 : 在 DTD 中 声明 元 素 “ 瞬 间 空 白 ” 为 空 元 素 ， 代 码 如 下 所 示 。 

<!ELEMENT 瞬间 空白 EMPTY> 

(2) ANY 表示 该 元 素 可 以 是 DID 中 定义 的 其 他 任何 元 素 或 已 经 编译 的 字符 数据 ， 包 括 
PCDATA、 元 素 、 元 素 和 PCDATA 的 混合 内 容 。 其 语法 格式 如 下 所 示 : 

<!ELEMENT 元 素 名 ANY> 

例如 : 在 存储 图 片 时 ， 往 往 因为 图 片 格式 的 不 同 而 不 确定 要 包含 的 数据 内 容 ， 那 么 使 用 
ANY 来 定义 图 片 的 类 型 是 再 合适 不 过 了 ， 代 码 如 下 所 示 : 

<!ELEMENT 图 片 ANY> 

(3) # 却 CDATA 表示 被 解析 的 字符 数据 。#PCDATA 类 型 的 元 素 不 能 包含 任何 子 元 素 ， 只 
能 包含 除 标记 外 的 字符 数据 ， 比 如 数字 、 字 符 和 符号 等 。 它 的 语法 格式 如 下 所 示 : 

<!ELEMENT 元 素 名 (#PCDATA)> 

例如 : 

<!ELEMENT 爱好 (#PCDRTR) > 

(4) 子 元 素 型 用 于 指定 某 个 元 素 可 以 包含 哪些 子 元 素 ， 语 法 格式 如 下 所 示 : 

<!ELEMENT 元 素 名 ( 子 元 素 名 称 ) > 

例如 : 

<!ELEMENT ”图书 (名称 ， 价 格 ) > 


<@— 


在 此 段 代 码 中 , 表示 的 是 在 根 元 素 “ 图 书 ” 下 包含 两 个 子 元 素 , 分别 是 “名 称 ” 和 “价格 ”。 
由 于 这 两 个 子 元 素 是 并 列 的 关系 ， 因 此 用 “ , ” 隔 开 ， 并 且 均 在 XML 文档 中 显示 ， 这 样 的 列 
表 形 式 被 称 为 元 素 型 的 序列 结构 。 

除了 序列 结构 ， 还 有 一 种 是 选择 结构 。 也 就 是 说 ， 选 择 定义 的 根 元 素 的 同时 也 可 以 选择 其 
根 元 素 要 使 用 的 子 元 素 ， 可 选 的 子 元 素 需 要 使 用 “|” 隔 开 。 例 如 : 

<!ELEMENT 性 别 ( 男 | 女 ) > 

在 上 述 代码 中 ， 元 素 “ 性 别 ” 必 须 从 子 元 素 “ 男 ”或 “ 女 ” 中 选择 一 个 作为 子 元 素 ， 绝 对 
不 能 包含 两 个 。 

(5) 混合 型 定义 的 元 素 不 但 可 以 包含 子 元 素 ， 而 且 可 以 包含 可 解析 的 字符 数据 ， 其 语法 格 
式 如 下 所 示 : 

<!ELEMENT 根 元 素 (#PCDATA| 子 元 素 ) *> 

在 此 语法 中 ， 混 含 内 容 元 素 的 声明 必须 遵循 这 一 格式 ， 即 以 各 CDATA 开始 ， 后 面 是 混 含 
内 容 中 可 能 出 现 的 子 元 素 类 型 。 而 星 号 “* ”代表 元 素 指 示 符 ， 需 要 放 在 右 括号 外 侧 ， 表 示 元 
素 可 以 多 次 出 现 。 

在 DTD 中 ， 可 以 作为 元 素 指示 符 的 还 有 几 个 ， 下 面 我 们 通过 表 3-2 来 将 这 些 指示 符 的 作 
用 罗列 出 来 。 

表 3-2 元 素 指示 符 


元 素 可 以 出 现任 意 多 次 ， 至 少 出 现 一 次 (大 1) 


元 素 可 以 出 现任 意 多 次 (过 0) 
元 素 要 么 出 现 一 次 要 么 不 出 现 (0 或 1) 


对 于 我 们 经 常 挤 公 交 的 人 来 说 ， 刷 卡 和 投 币 都 不 陌生 吧 。 从 每 位 乘客 的 角度 来 分 析 ， 必 须 
刷卡 或 者 投 币 方 能 乘坐 公交 车 。 但 从 众多 乘客 的 角度 来 分 析 ， 刷 卡 或 者 投 币 的 情况 必定 大 于 等 
于 一 次 。 下 面 ， 我 们 做 个 小 例子 。 

<?xml version="1.0" encoding="utf-8" standalone="yes" ?> 

<1DOCTYPE 公交 车 [ 

<!ELEMENT 公交 车 (乘客 , (刷卡 , 投 币 +)+ ， 上 车 ) > 

<!ELEMENT 乘客 (#PCDATA)> 
<!ELEMENT 刷卡 (#PCDATA)> 
<!ELEMENT 投 币 (#PCDRTR) > 

] > 

< 公交 车 > 

< 乘客 >A 乘客 </ 乘 客 > 
< 刷卡 > 月 票 </ 刷 卡 > 
< 投 币 >1 元 </ 投 币 > 


< 刷卡 > 电子 钱包 </ 刷 卡 > 
< 投 币 >1 元 </ 投 币 > 
< 刷卡 > 月 票 </ 刷 卡 > 


< 投 币 >1 元 </ 投 币 > 


</ 公 交 革 > 
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在 该 文档 的 DTD 中 ， 定 义 了 根 元 素 “ 公 交 车 ”及 其 四 个 子 元 素 ， 其 中 刷卡 和 投 币 至 少 出 


现 一 次 。 


到 目前 为 止 ，DTD 对 元 素 的 声明 就 告 一 段落 了 。 下 面 我 们 来 看 一 下 DTD 对 属性 的 声明 。 

属性 的 作用 主要 是 用 来 描述 元 素 的 额外 信息 的 。 在 DTD 中 , 我 们 使 用 ATTLIST 关键 字 来 
定义 元 素 的 属性 ， 其 语法 格式 如 下 所 示 。 

<!ATTLIST 元 素 名 属性 名 属性 类 型 属性 默认 值 > 

在 DTD 中 有 以 下 几 种 属性 类 型 ， 如 表 3-3 所 示 。 


IDREF 
IDREFS 
ENTITY 
ENTITIES 
NMTOKEN 
NMTOKENS 
NOTATION 


表 3-3 DTD 中 的 属性 类 型 


含义 
字符 数据 ， 即 没有 标记 的 文本 
可 选择 的 可 能 值 列表 
不 被 文档 中 任何 其 他 ID 类 型 属性 共享 的 唯一 名 称 
文档 中 元 素 的 ID 类 型 的 属性 值 
由 空格 分 隔 元 素 的 多 个 ID 
在 DTD 中 声明 的 实体 的 名 称 
在 DTD 中 声明 由 空格 分 隔 的 多 个 实体 的 名 称 
XML 名 称 记 号 
由 空格 分 隔 的 多 个 XML 名 称 记号 
在 DTD 中 可 以 向 应 用 程序 指定 一 个 外 部 的 处 理 程序 


在 DTD 中 的 属性 默认 值 如 表 3-4 所 示 。 


表 3-4 DTD 中 的 属性 默认 值 


属性 默认 值 含 义 
#REQUIRED 元 素 的 每 个 实例 必须 包含 该 属性 


AIMPLIED | 元 素 实例 可 以 选择 是 否 包含 该 属性 
属性 的 值 永远 定位 默认 值 ， 如 果 元 素 中 不 包含 该 属性 的 属性 值 ， 解 析 器 会 
#IXED+ 默 认 值 
将 默认 值 作为 属性 值 
本 如 果 元 素 中 不 包含 该 属性 的 属性 值 ， 解 析 器 会 将 默认 值 作为 属性 值 ， 否 则 


该 属性 可 以 有 其 他 属性 值 


4. DTD 中 的 实体 


前 面 为 我 们 介绍 了 5 种 预定 义 的 实体 引用 ， 分 别 用 来 引用 5 个 内 置 的 符号 实体 ， 只 有 这 些 
是 远 远 不 够 的 。 因 此 XML 提供 了 实体 定义 ， 可 以 使 用 户 将 经 常 使 用 的 文本 段 定 义 为 实体 ， 这 
样 ， 用 户 就 能 够 快速 地 引用 该 文本 段 的 实体 了 。 

在 DTD 中 , 主要 分 为 两 种 实体 , 分 别 是 普通 实体 和 参数 实体 。 首先 我 们 来 看 一 下 普通 实体 。 
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@ 服务 开发 学 习 实录 .… 


1) ”普通 实体 

普通 实体 在 文档 中 的 格式 是 : 以 “&” 开 始 ， 以 “;” 结 束 ， 在 两 字符 之 间 的 是 在 DTD 中 
定义 的 实体 名 称 。 普 通 实体 又 可 分 为 内 部 普通 实体 和 外 部 普通 实体 。 内 部 普通 实体 是 在 DTD 
的 内 部 定义 ， 从 而 被 文档 引用 的 实体 ， 语 法 格式 如 下 所 示 : 


<!ENTITY name "text"> 


在 此 语法 中 ，ENTITY 指 的 是 实体 关键 字 ， 表 明定 义 的 是 一 个 实体 。name 指 的 是 实体 引 
用 名 称 ， 可 以 在 XML 文档 中 使 用 的 实体 引用 。“text” 指 的 是 实体 的 内 容 。 
下 面 我 们 来 看 一 个 例子 ， 代 码 如 下 所 示 : 


<?xml Version="1.0"” encoding="utf-8" standalone="yes" ?> 
<!1DOCTYPE 公交 车 师傅 [ 

<!ENTITY title "爱情 公寓 搞笑 台词 "> 

<!ELEMENT 公交 车 师傅 (标题 , 展播 , 保镖 ) > 

<!ENTITY zhanbo "你 ， 要 么 刷卡 ， 要 么 投 币 ， 扭 什么 扭 ! "> 

<!ENTITY baobiao " 哎 ， 回 来 ! 要 么 刷卡 ， 要 么 投 币 ， 看 什么 看 ! 公交 车 都 坐 不 起 ， 还 冒充 黑客 
帝国 ， 哼 ! "> 

<!ELEMENT 标题 (#PCDATA)> 

<!ELEMENT 展播 (#PCDRTR) > 

<!ELEMENT 保镖 (#PCDRTR) > 


1 
< 公交 车 师傅 > 

< 标题 >stitle;</ 标 题 > 

< 展播 >szhanboy </ 展 播 > 

< 保镖 >sbaobiao;</ 保 镖 > 
</ 公 交 车 师傅 > 


在 该 文档 中 的 DTD 中 ， 我 们 定义 了 三 个 内 部 普通 实体 ， 分 别 是 tile、zhanbo 和 baobiao。 
然后 定义 文档 中 的 根 元 素 及 其 子 元 素 。 运 行 该 XML 文档 ， 文 档 中 引用 实体 的 地 方 将 被 实体 的 
内 容 所 代替 。 执 行 的 结果 如 图 3-11 所 示 。 


人 
要 入 扫 而， 和 什么 


刷卡 ， a 
人 a 要 么 投 而 ， Ee 公交 车 都 旦 不 起 ,还 时 


如 a 


3-11 引用 内 部 普通 实体 的 效果 


外 部 普通 实体 是 指 实体 引用 文件 在 文档 外 部 ， 通 过 URI 引用 到 DTD 中 ， 之 后 方 可 被 文档 
引用 ,来 看 一 下 它 的 语法 格式 。 
<!ENTITY name SYSTEM "URI"> 


在 该 语法 中 ，name 为 实体 的 引用 名 ，URI 为 有 效 的 链接 资源 。 下 面 我 们 使 用 外 部 普通 实 
体 来 做 一 个 小 例子 ， 以 便 加 深 我 们 对 外 部 实体 的 引用 ， 如 下 所 示 : 


Eee >> 
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首先 ， 创 建 一 个 名 称 为 XML.xml 的 文件 ， 并 添加 如 下 代码 : 


<?xml version="1.0" encoding="utf-8" ?> 


哎 ， 回 来 ! 要 么 刷卡 ， 要 么 投 币 ， 看 什么 看 ! 公交 车 都 坐 不 起 ， 还 冒充 黑客 帝国 ， 哼 ! 
然后 再 创建 一 个 名 称 为 wai.xml 的 文件 ， 代 码 如 下 : 


<?xml version="]1.0" encoding="utf-8" standalone="yes" ?> 
<!1DOCTYPE 公交 车 师傅 [ 
<!ENTITY title "爱情 公寓 搞笑 台词 "> 
<!ELEMENT 公交 车 师傅 (标题 , 保镖) > 
<!ENTITY zhanbo "你 ， 要 么 刷卡 ， 要 么 投 币 ， 扭 什么 扭 ! "> 
<!ENTITY baobiao SYSTEM "XML .xm]1"> 
<!ELEMENT 标题 (#PCDRTR) > 
<!ELEMENT 保镖 (#PCDRTR) > 
]> 
< 公交 车 师傅 > 
< 标题 >stitle;</ 标 题 > 
< 保镖 >sbaobiao;</ 保 镖 > 
</ 公 交 车 师傅 > 


保存 代码 。 
运行 程序 ， 执 行 的 结果 如 图 3-12 所 示 。 


图 3-12 使 用 外 部 普通 实体 引用 的 效果 


通过 上 面 的 介绍 ,我 们 了 解 了 什么 是 普通 实体 ， 以 及 内 部 和 外 部 普通 实体 的 使 用 。 接 下 来 
要 讲 的 是 参数 实体 。 

2) ”参数 实体 

普通 实体 在 DTD 中 定义 ， 在 XML 文档 中 引用 ， 通 过 解析 器 将 实体 变 成 文档 中 的 一 部 分 。 
而 参数 实体 只 能 在 DTD 中 定义 ， 并 且 在 DID 中 使 用 ， 而 与 XML 文档 无 关 。 

参数 实体 引用 是 以 “% ”开头 ， 以 “:” 结 束 的 。 由 于 参数 实体 引用 的 方式 不 同 ， 因 此 可 以 
划分 为 内 部 参数 实体 引用 和 外 部 参数 实体 引用 。 

声明 内 部 参数 实体 的 格式 如 下 所 示 : 

<!IENTITY $ name "text"> 

在 该 语法 中 ，name 指 的 是 参数 实体 的 引用 名 称 ，text 指 的 是 参数 实体 的 内 容 。 

下 面 我 们 通过 一 个 小 例子 来 说 明 一 下 。 

首先 创建 一 个 名 称 为 neiCan.dtd 文件 ， 并 添加 如 下 代码 : 


<@—— 


<?xml version="1.0" encoding="utf-8" ?> 
<!ELEMENT 班级 (Y20711) > 

<!ENTITY % name "姓名 "> 

<!ENTITY Y20711 "%name;" > 

<!ELEMENT 姓名 (#PCDATA) > 

<!ELEMENT 成 绩 (#PCDATA) > 

<!ELEMENT Y20711 (#PCDATA)> 


在 上 述 代 码 中 ， 声 明了 内 部 参数 实体 name， 接 着 在 内 部 使 用 “%name:” 的 方式 引用 。 
接着 ， 创 建 一 个 名 称 为 neiCan.xml 的 文件 ， 添 加 如 下 代码 : 


<?xml] Version="1.0"” encoding="utf-8" standalone="no"?> 
<!DOCTYPE 班级 SYSTEM "neican.dtd" > 
< 班级 > 
<Y20711> 
< 姓名 >dcy</ 姓 名 > 
</Y20711> 
</ 班 级 > 


保存 完成 的 代码 。 
运行 程序 的 结果 如 图 3-13 所 示 。 


NT PER TE 
图 3-13 ”内 部 参数 实体 引用 的 效果 


接着 我 们 来 看 外 部 参数 实体 的 引用 。 

在 XML 文档 中 ,会 有 很 多 的 属性 和 元 素 ， 那 么 DTD 的 声明 就 会 比较 复杂 ， 因 此 不 利于 
以 后 的 维护 和 更 新 。 有 时 ， 用 户 有 可 能 在 多 个 文档 中 需要 声明 DTD 文件 中 同一 部 分 的 元 素 和 
属性 ， 这 样 就 会 造成 代码 的 元 余 。 而 外 部 参数 实体 就 可 以 解决 这 个 问题 ， 来 增强 元 素 声明 的 通 
用 性 。 

外 部 参数 实体 是 指 一 个 DID 可 以 链接 到 另 一 个 DTD 上 ， 从 而 得 到 第 一 个 DTD 中 的 元 素 
以 及 属性 的 声明 。 其 语法 格式 如 下 所 示 。 

<!ENTITY $% name "URI"> 


在 该 语法 中 ，name 为 外 部 参数 实体 的 引用 名 称 ，URI 为 外 部 DTD 的 URL。 
下 面 我 们 来 看 一 个 例子 。 

首先 ， 创 建 一 个 名 为 canDTD.dtd 的 文件 ， 其 代码 如 下 所 示 : 

<2?xml version="1.0" encoding="utf-8" ?> 


<!ELEMENT 学 生 (姓名 , 成绩) > 
<!ELEMENT 姓名 (#PCDRTR) > 
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<!ELEMENT 成 绩 (#PCDATA)> 


然后 ， 新 添加 一 个 名 为 tianCAN.dtd 的 文件 ， 其 代码 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8" ?> 
<!ELEMENT 班级 (班级 名 称 , 学 生 *)> 
<!ELEMENT 班级 名 称 (#PCDATA) > 

<!ELEMENT 学 生 (#PCDATA)> 

<!ENTITY % work SYSTEM "canDTD.dtd"> 


在 上 述 代码 中 , 我 们 使 用 了 “<!ENTITY % name“URT> ”的 方式 来 引用 外 部 的 DTD 文件 。 
接着 ， 创 建 一 个 名 称 为 waiCAN.xml 的 文件 ， 代 码 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8" standalone="no" ?> 
<!DOCTYPE 班级 SYSTEM "tianCAN.dtd" > 
< 班级 > 
< 班级 名 称 >Y20828</ 班 级 名 称 > 
< 学 生 > 
< 姓名 >dcy</ 姓 名 > 
< 成 绩 >89</ 成 绩 > 
</ 学 生 > 
< 学 生 > 
< 姓名 >1y</ 姓 名 > 
< 成 绩 >90</ 成 绩 > 
</ 学 生 > 
< 学 生 > 
< 姓名 >1dx</ 姓 名 > 
< 成 绩 >50</ 成 绩 > 
</ 学 生 > 
< 学 生 > 
< 姓名 >1ws</ 姓 名 > 
< 成 绩 >85</ 成 绩 > 
</ 学 生 > 
</ 班 级 > 


在 此 段 代码 中 ， 我 们 使 用 “<!DOCTYPE 班级 SYSTEM "tianCAN.dtd">” 引 用 外 部 参数 
实体 。 
运行 程序 的 结果 如 图 3-14 所 示 。 


3-14 引用 外 部 参数 实体 的 效果 


<E@— 


3.6.2 ”实例 描述 


我 有 一 个 网 站 后 台 ， 想 用 XML 文档 的 形式 展现 出 来 ， 刚 好 在 上 面 我 们 讲 过 DTD 的 实体 ， 
我 有 一 种 想 试 一 试 的 冲动 。 
下 面 就 来 看 一 下 我 的 实现 方案 。 


3.6.3 ”实例 应 用 


【 例 3-4】 制作 精彩 的 树 状 后 台 
(1) 创建 一 个 DTD 文件 ， 名 称 为 ShuZhuang.dtd。 
(2) 在 ShuZhuang.dtd 文件 中 ， 添 加 如 下 代码 : 


<?Xml version="1.0" encoding="utf-8" ?> 


<!ELEMENT 关于 我 们 
<!ELEMENT 公司 简介 
<!ELEMENT 荣誉 资质 
<!ELEMENT 分 类 管理 
<!ELEMENT 子 类 管理 
<!ELEMENT 新 闻 中 心 
<!ELEMENT 公司 新 闻 
<!ELEMENT 产品 中 心 
<!ELEMENT 产品 展示 
<!ELEMENT 最 新 产品 
<!ELEMENT 客户 服务 


(公司 简介 , 荣誉 资质 ,分 类 管理 , 子 类 管理 ) > 
(#PCDATA) > 

(#PCDATA) > 

(#PCDATA) > 

(#PCDATA) > 

(公司 新 闻 , 分 类 管理 , 子 类 管理 ) > 
(#PCDATA) > 

(产品 展示 , 最 新 产品 ,分 类 管理 , 子 类 管理 ) > 
(#PCDATA) > 

(#PCDATA) > 

(客户 服务 1, 分 类 管理 , 子 类 管理 ) > 


<!ELEMENT 客户 服务 1 (#PCDRTR) > 
<!ELEMENT 经 典 案例 (分 类 管理 , 子 类 管理 ) > 


(3) 创建 一 个 名 称 为 ShuZhuangTian.dtd 文件 。 
(4) 在 ShuZhuangTian.dtd 文件 中 添加 如 下 代码 : 


<?xml Version="1.0"” encoding="utf-8"?> 

<!ELEMENT 后 台 管 理 (后 台 名 称 , 关于 我 们 , 新 闻 中 心 , 产品 中 心 , 客户 服务 , 经典 案例 *) *> 
<!ELEMENT 后 台 名 称 (#PCDATA) > 

<!ELEMENT 关于 我 们 (#PCDATA) > 

<!ELEMENT 新 闻 中 心 (#PCDATA) > 

<!ELEMENT 产品 中 心 (#PCDATA) > 

<!ELEMENT 客户 服务 (#PCDATA) > 

<!ELEMENT 经 典 案例 (#PCDATA) > 

<!ENTITY % work SYSTEM "ShuZhuang .dtd"> 


(5) 创建 一 个 名 称 为 ShuZhuang.xml 文件 ， 并 添加 如 下 代码 : 


<?xml version="1.0" encoding="utf-8" standalone="no" ?> 
<!1DOCTYPE 后 台 管 理 SYSTEM "shuzhuangTian.dtd"> 
< 后 台 管理 > 
< 后 台 名 称 > 我 的 后 台 管 理 </ 后 台 名 称 > 
< 关于 我 们 > 
< 公司 简介 ></ 公 司 简介 > 


Esc >> 
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< 荣誉 资质 ></ 荣 誉 资质 > 
< 分 类 管理 ></ 分 类 管理 > 
< 子 类 管理 ></ 子 类 管理 > 
</ 关 于 我 们 > 
< 新 闻 中 心 > 
< 公司 新 闻 ></ 公 司 新 闻 > 
</ 新 闻 中 心 > 
< 产品 中 心 > 
< 产品 展示 ></ 产 品 展示 > 
< 最 新 产品 ></ 最 新 产品 > 
</ 产 品 中 心 > 
< 客户 服务 > 
< 客户 服务 1></ 客 户 服务 1> 
</ 客 户 服务 > 
< 经 典 案例 > 
< 分 类 管理 ></ 分 类 管理 > 
< 子 类 管理 ></ 子 类 管理 > 
</ 经 典 案例 > 
</ 后 台 管 理 > 


保存 修改 好 的 代码 。 


3.6.4 ”运行 结果 


运行 程序 的 结果 如 图 3-15 所 示 。 


图 3-15 XML 的 后 台 展 示 效 果 


3.6.5 ”实例 分 析 


rm. 


在 本 实例 中 ，ShuZhuangxml 中 引用 了 外 部 参数 实体 ShuZhuangTian.dtd 文件 。Shu 
ZhuangTian.dtd 文件 又 链接 了 ShuZhuang.dtd 文件 ， 从 而 完成 了 此 网 站 后 台 的 目录 结构 。 
是 不 是 很 简单 啊 。 


<@— 


3.7 ”常见 问题 解答 


3.7.1 关于 XML 中 命名 空间 的 问题 


关于 XML 中 命名 空间 的 问题 。 
网 络 课堂 : http://bbs.itzcn.com/thread-15024-1-1.html 


创建 了 一 个 XML 文件 , 其 中 主要 包括 两 部 分 , 第 一 部 分 使 用 table 元 素 包 含 了 水 果 的 信息 。 
代码 如 下 所 示 : 


<table> 
EE 
<td>Apples</td> 
<td>Bananas</td> 
</tr> 
</table> 


第 二 部 分 又 使 用 table 元 素 包含 了 桌子 的 信息 ， 如 下 所 示 : 


<table> 
<name>African Coffee Table</name> 
<width>80</width> 
<length>120</length> 

</table> 


由 于 这 两 个 XML 代码 都 包含 了 table 元 素 ， 但 是 这 两 个 table 元 素 的 定义 和 所 包含 的 内 容 
各 不 相同 ， 我 该 怎么 办 才能 将 这 两 个 XML 代码 中 的 table 元 素 给 区 别 开 呢 ? 

【解决 办 法 】 

在 XML 文档 中 ， 你 可 以 使 用 命名 空间 将 这 两 个 XML 代码 中 的 table 元 素 区别 开 。 

第 一 部 分 包含 水 果 的 信息 的 table 元 素 ， 代 码 如 下 所 示 : 


<h:table xmlns:h="http://www.w3.org/TR/htm14/"> 
<hstr> 
<h:td>Apples</h:td> 
<h:td>Bananas</h:td> 
< ER 
</h:table> 


第 二 部 分 包含 桌子 的 信息 的 table 元 素 ， 代 码 如 下 所 示 : 


<f:table xmlns:f="http://www.w3schools.com/furniture"> 
<f:name>African Coffee Table</f:name> 
<f:width>80</f:width> 
<f:length>120</f:1length> 

</f:table> 
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在 上 面 的 例子 中 除了 使 用 前 缀 外 ， 两 个 table 元 素 都 使 用 了 xmlns 属性 ， 使 元 素 和 不 同 的 
命名 空间 关联 到 一 起 。 


3.7.2 XML 中 的 CDATA 区 和 注释 有 什么 区 别 


面 岗 ”XML 中 的 CDATA 区 和 注释 有 什么 区 别 ? 
[全 全 。 网络 课 堂 : http:/bbs itzcn.comy/thread-15025-1-1.html 


最 近 我 正在 学 习 XML， 但 学 到 CDATA 区 时 ， 我 甚 感 迷 惑 。 因 为 我 觉得 CDATA 和 注释 
的 功能 是 一 样 的 ， 都 是 不 被 解析 器 解析 。 和 希望 能 具体 分 析 一 下 ， 谢 谢 大 侠 。 

【解决 办 法 】 

首先 ，CDATA 的 功能 是 还 原 该 语句 的 本 来 含义 。 在 XML 文档 中 “<” 这 个 符号 是 一 个 节 
点 的 开始 符号 。 例如: 有 一 个 字符 串 “ 我 家 门 前 有 棵 葡萄 树 ”， 如 果 将 该 字符 串 放 在 节点 中 间 ， 
当 解 析 器 解析 到 “<” 的 时 候 就 会 报错 。 但 是 ， 当 我 们 加 上 CDATA 的 时 候 ， 意 思 就 是 告诉 解 
析 器 ， 这 里 面 的 内 容 不 希望 被 解析 ， 而 是 希望 直接 输出 。 


3.7.3 XML 文件 引用 外 部 DTD 文件 的 问题 


回 王 ”XML 文件 引用 外 部 DTD 文件 的 问题 
[全 全 网络 课堂 : http://bbs.itzen.com/thread-15026-1-1.html 


我 创建 了 一 个 XML 文件 ， 其 代码 如 下 所 示 : 


<?xml] Version="1.0"” encoding="utf-8" ?> 
<!DOCTYPE Title SYSTEM "xyl.dtd"> 
<Title>[ 部 2010-7-14 11:08:47]</Title> 


在 该 代码 中 引用 了 DID 文件， 代码 如 下 所 示 : 


<?xml] version="1.0" encoding="utf-8"?> 
<!ENTITY amp "&"> 
<!ENTITY reg "@"> 
<!ENTITY nbsp " "> 


这 两 个 文件 在 同一 路 径 下 ， 但 运行 时 提示 “XML 解析 错误 : 未 定义 的 实体 ”。 
位 置 : http://xiaobin.com/xy.xml 

行 : 9， 列 : 9: 

<Title>[ 专线 部 2010-7-14 11:08:47]</Title>， 在 线 等 …. 

【解决 办 法 】 

你 只 需要 简单 地 将 DTD 文件 修改 一 下 即 可 ， 如 下 所 示 : 

<?xml version="1.0" encoding="utf-8"?> 

<1ELEMENT Title (#PCDATA)> 


<!ENTITY reg "@"> 
<IENTITY nbsp ™ ™»> 


<@— 


保存 之 后 再 运行 ， 效 果 如 图 3-16 所 示 。 


http://localhost:1366/WebXal¥eb/ShuZhuang. xal - 


€ localhost 


高 必 闵 天 。 车 http:/1localhost-13 


<?xml version="1.0" encoding="utf-8” standalone= no" ?> 
<IDOCTYPE Title (View Source for full doctype...)> 
<Tide>[ 部 2010-7-14 11:08:47]</Tite> 


图 3-16 成 功 运行 时 的 效果 
3.8 习 题 


一 、 填 空 题 

(1) 在 XML 文档 中 ， 表示 使 用 DTD 的 形式 ， 值 只 能 是 yes 或 者 no。 

(2) 在 XML 文档 中 声明 命名 空间 ， 使 用 的 关键 字 是 

(3) XML 文档 中 的 字符 “&lt;” 和 “&gt”， 其 中 “&lt;” 字 符 在 文档 中 显示 的 效果 是 “<”， 
那么 字符 “&gt” 在 文档 中 显示 的 效果 是 


(4) 是 用 来 包含 文本 的 方法 ， 通 常用 于 建立 代码 的 脚本 ， 如 JavaScript、 
VBScript 等 。 
(5) 声明 文档 类 型 定义 DTD， 需 要 使 用 关键 字 。 
(6) 在 DTD 对 元 素 的 声明 过 程 中 ， 其 中 用 来 表示 空 元 素 。 
(7) XML 提供 了 实体 定义 ， 在 DTD 中 主要 分 为 普通 实体 和 
二 、 选 择 题 
(1) 在 XML 文档 的 序言 中 包括 XML 的 声明 和 注释 两 部 分 ， 其 中 在 XML 的 声明 中 ， 
standalone 表示 是 否 引用 外 部 实体 ， 当 standalone 的 值 为 时 ， 说 明 需 要 引用 外 部 
A. yes B. no C. ture D. false 
(2) 在 下 面 的 几 个 选项 中 ， 声明 命名 空间 是 正确 的 。 
光 


<goods xmlns:info="http://www.qzxian.com/SkinCare"> 
B. 
<goods info="http://www.qxian.com/SkinCare"> 


C 


<goods xmlns:info:http://www.qxian.com/SkinCare"> 


m= >> 


下 : 
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<goods xmlns:info http://www-qxian-com/SkinCare"> 


(3) 有 这 样 一 个 作者 , 他 出 了 很 多 本 图 书 , 并 且 有 的 一 本 图 书 还 可 以 被 不 同 的 出 版 社 出 版 ， 
且 作者 简历 可 有 可 无 。 那 么 在 DTD 中 上 声明 该 图 书 元 素 正确 的 是 


A 


<!DOCTYPE 图 书 [ 

<!ELEMENT 图 书 (作者 ，( 书 名 , 出 版 社 +)+ 
<!ELEMENT 作者 (#PCDRTR) > 
<!ELEMENT 书 名 (#PCDRTR) > 
<!ELEMENT 出 版 社 (#PCDRATR) > 

| 


Bs 


<!DOCTYPE 图 书 [ 

<!ELEMENT 图 书 (作者 ，( 书 名 , 出 版 社 +)+ 
<!ELEMENT 作者 (#PCDRTR) > 
<!ELEMENT 书 名 (#PCDRTR) > 
<!ELEMENT 出 版 社 (#PCDRTR) > 
<!ELEMENT 作者 简历 (#+PCDRTR) > 

i 


C。 


<!DocTYPE 图 书 [ 

<!ELEMENT 图 书 (作者 ，( 书 名 , 出 版 社 +)+ 
<!ELEMENT 作者 (#PCDRTR) > 
<!ELEMENT 书 名 (#PCDRTR) > 
<!ELEMENT 出 版 社 (#PCDRTR) > 
<!ELEMENT 作者 简历 (#PCDATA) > 

]> 


D: 


<!DOCTYPE 图 书 [ 

<!ELEMENT 图 书 (作者 ，( 书 名 ,出 版 社 +)+ 
<!ELEMENT 作者 (#PCDATA)> 
<!ELEMENT 出 版 社 (#PCDRTR) > 
<!ELEMENT 作者 简历 (#PCDATA)> 

TE 


,作者 简历 ?2) > 


,作者 简历 ) > 


,作者 简历 ?) > 


,作者 简历 ?) > 


(4) 类 似 于 一 个 单 选 按钮 ， 例 如 : 男 或 女 ， 需 要 选择 其 中 的 一 个 元 素 ， 使 其 显示 在 XML 


文档 上 ， 那 么 我 们 可 以 使 用 
A, 
<!ELEMENT 性 别 ( 男 # 女 )> 
B. 
<!ELEMENT 性 别 ( 男 |, 女 )> 


< 


m= >> 


5 

<!ELEMENT 性 别 ( 男 ， 女 )> 
D; 

<!ELEMENT 性 别 ( 男 | 女 ) > 


三 、 上 机 练习 


上 机 练习 1: 内 部 普通 实体 的 引用 。 
通过 对 本 章 的 学 习 ， 我 们 对 XML 的 基础 有 了 大 致 的 了 解 。 例 如 : 如 何 声明 XML、XML 
的 标记 与 元 素 、 在 XML 中 字符 和 实体 的 引用 以 及 CDATA 的 使 用 ， 另 外 本 章 还 介绍 了 文档 类 
型 定义 DTD。 那 么 这 次 的 上 机 练习 ， 针 对 的 是 实体 引用 。 
在 本 次 上 机 练习 中 ， 我 们 使 用 的 是 内 部 引用 普通 实体 ， 下 面 将 给 出 实体 引用 的 代码 : 
< 诗句 > 
< 标题 >stitile;</ 标 题 > 
<ldy>&ldy; </1ldy> 
</ 诗 句 > 


使 其 显示 效果 如 图 3-17 所 示 。 


袖 收 藉 赤 | 同 Mt:1lvealhest 13 全 "- 国 - 口 师 " 6o- 


f-8" standalone="yes" ?> 


</ 标 题 


/标题 > 
<dy > 两 厅 拟 璧 非 必 澡 烟 居 ， 一 双 似 喜 非 春 舍 情 日 。 老 生 两 司 之 屯 ， 刀 
玫 一 身 之 病 。 词 光 点 点 ， 娇 晓 短 向 。 闲 豌 时 如 六 在 照 水 ， 行 动 处 似 弱 
棉 扶风 。 心 物 比 干 杀 一 高 ， 病 如 西子 胜 三 分 。</Idy> 
/二 各 > 


图 3-17 最 终 的 显示 效果 
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内 容 摘要 : 


众所周知 ，Web 服务 的 优势 之 一 就 是 能 够 跨 平 台 、 跨 系统 。 那么 在 这 些 平台 上 调用 时 如 何 
正确 地 处 理 和 传递 数据 便 成 为 困扰 开发 人 员 的 一 个 问题 。 例 如 ， 一 些 语言 使 用 32 位 来 存储 整 
数 ， 而 其 他 语言 只 使 用 16 位 来 存储 整数 等 类 似 情况 。 当 试图 在 这 些 不 同 的 系统 之 间 进 行 通信 
时 ， 就 会 导致 彼此 根本 无 法 理解 与 转换 ， 甚 至 使 系统 谣 溃 。 

好 在 Web 服务 的 另 一 个 优势 是 基于 XML 的 。 这 就 意味 着 用 来 传递 Web 服务 数据 的 XML 
不 应 该 存在 特定 于 系统 或 平台 的 数据 类 型 。 也 就 是 说 ， 需 要 在 XML 中 使 用 一 个 各 种 平台 都 支 
持 、 都 理解 的 类 型 系统 来 传递 类 型 信息 。 

而 目前 , 属于 XML 规范 的 XML Schema Definition 所 定义 的 类 型 系统 已 经 被 很 多 软件 开发 
商 支 持 。 因 此 ，Web 服务 为 了 解决 类 型 不 兼容 问题 理所当然 地 采用 这 个 类 型 系统 ， 即 XSD 类 
型 系统 。 

学 习 目标 : 

了 解 XSD 与 DTD 的 区 别 

掌握 XSD 文档 的 创建 方式 和 命名 空间 的 使 用 
掌握 如 何 为 简易 元 素 定义 数据 类 型 

掌握 在 XSD 中 对 元 素 进行 限制 、 联 合 和 列表 的 方法 
熟悉 匿名 类 型 的 使 用 

掌握 如 何 定义 一 个 复杂 数据 类 型 

掌握 简单 类 型 和 纯 元 素 类 型 的 使 用 方法 

了 解 混合 类 型 和 空 类 型 的 使 用 方法 
掌握 如 何 声 明 XSD 元 素 和 属性 

熟悉 如 何 通过 程序 验证 XSD 文档 

了 解 二 进 制 数据 的 传输 方法 


4.1 什么 是 XSD 


XSD 是 XML Schema Definition 的 简写 ， 也 被 称 为 XML Schema 语言 ， 它 是 以 XML 语言 
为 基础 的 。 同 DTD 一 样 ，XSD 也 是 描述 XML 文档 结构 的 一 种 方式 。 但 是 ， 除 了 描述 文档 结 
构 外 ，XSD 还 能 限制 文本 数据 的 实际 类 型 ， 这 是 DTD 所 不 能 比拟 的 。 


4.1.1 网 络 教 学 
名 视频 教学 : 光盘 /videos/04/ 什 么 是 XSD avi @@ 长 度 : 5 分 名 


4.1.2 ”基础 知识 一 一 XSD 简介 


上 一 章 我 们 学 习 了 DTD,， 使 用 它 能 够 约束 XML 文件 的 标记 和 树 形 结构 ， 而 不 涉及 文本 的 
具体 内 容 。 但 如 果 需 要 指定 标记 内 容 的 “数据 类 型 ”( 例 如 整数 、 小 数 、 字 符 数据 等 ), 那么 XSD 
则 是 最 佳 的 选择 。 

可 以 说 XSD 是 DTD 的 一 个 替代 产品 ，XSD 由 一 套 预先 定义 的 XML 元 素 和 属性 组 成 ， 具 
有 一 致 性 、 扩 展 性 、 互 换 性 、 规 范 性 、 数 据 类 型 多 样 性 等 特点 。 使 用 XSD 可 以 完成 如 下 工作 : 

@ ”定义 可 出 现在 文档 中 的 元 素 ; 
定义 可 出 现在 文档 中 的 属性 ; 
定义 哪个 元 素 是 子 元 素 ; 
定义 子 元 素 的 次 序 ; 
定义 子 元 素 的 数目 ; 
定义 元 素 是 否 为 空 ， 或 者 是 否 可 包含 文本 ; 
定义 元 素 和 属性 的 数据 类 型 ; 

@ ”定义 元 素 和 属性 的 默认 值 以 及 固定 值 。 

我 们 可 以 用 一 个 指定 的 XSD 来 验证 某 个 XML 文档 , 以 检查 该 XML 文档 是 否 符合 其 要 求 。 
还 可 以 通过 XSD 指定 一 个 XML 文档 所 允许 的 结构 和 内 容 ,并 可 据 此 检查 一 个 XML 文档 是 否 
是 有 效 的 。 

另外 ， 由 于 XSD 本 身 是 一 个 XML 文档 ， 因 此 可 以 用 通用 的 XML 解析 器 解析 它 。 

目前 XSD 有 两 种 标准 : Microsoft XML Schema 和 W3C XML Schema。 这 两 种 标准 在 定义 
XML 文档 时 是 相同 的 ， 只 是 结构 声明 、 描 述 、 命 名 空间 的 使 用 和 Schema 文件 的 后 缀 名 不 同 。 
在 这 里 ， 我 们 以 最 常用 的 W3C XML Schema 为 例 进行 介绍 。 

在 W3C XML Schema 标准 中 ， 根 元 素 必 须 以 “<xs:schema> ”或 “<xsd:schema> ”开始 ， 
而 且 所 有 元 素 及 属性 的 声明 均 是 以 “xsd” 和 “xs” 开 头 。XSD 文件 以 “xsd” 为 扩展 名 进行 
保存 。 


Ed 人) >> 
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例如 ， 下 面 给 出 一 个 XSD 文档 的 结构 代码 : 


<?xml version="1.0" encoding="utf-8"?> 
<xs:schema xmlns:xs=" 命 名 空间 "> 
元 素 声 明 部 分 或 属性 声明 部 分 
</xs:schema> 
通常 引用 的 命名 空间 为 “http://www.w3.org/2001/XMLSchema”， 元 素 或 属性 的 声明 视 文 
档 内 容 而 定 。 
例如 ， 要 发 送 一 条 短信 ， 首 先 必须 有 收 信 人 和 发 信人 ， 此 外 标题 以 及 信息 内 容 也 是 必 不 可 
少 的 。 如 下 的 代码 演示 了 使 用 XSD 来 定义 短信 XML 文档 中 的 元 素 结构 和 类 型 : 
<?xml] version="1.0" encoding="utf-8"?> 
<xs:schema xmlns:xs="http://www.w3.0rg/2001/XMLSchema"> 
<xs:element name="message"> 
<xs:complexType> 
<xs:sequence> 
<xs:element name="to" type="xs:string"/> 
<xs:element name="from" type="xs:string"/> 
<xs:element name="title" type="xs:string"/> 
<xs:element name="body" type="xs:string"/> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
</xs:schema> 


这 只 是 一 个 简单 示例 ， 旨 在 帮助 读者 快速 了 解 XSD 的 概况 。 在 本 节 后 面 将 详细 学 习 各 个 
部 分 的 内 容 。 


4.2 根据 XML 文件 定义 简易 元 素 


在 开发 和 使 用 Web 服务 的 过 程 中 ， 经 常 需 要 创建 新 的 XSD 架构 或 者 读 取 并 理解 已 有 的 
XSD 架构 ， 甚 至 有 时 候 需要 修改 XSD 架构 。 在 这 一 节 中 , 我 们 来 学 习 基于 XSD 类 型 系统 如 何 
定义 最 基本 的 元 素 。 


A9 
wy 视频 教学 : 光盘 /videos/04/ 定 义 简易 元 素 .avi @@ 长 度 : 9 分 钟 


4.2.1 基础 知识 一 一 定义 简易 元 素 


简易 元 素 具有 不 可 再 分 性 ， 是 指 仅 包含 文本 的 元 素 。 它 不 会 再 包含 其 他 任何 元 素 或 属性 。 
不 过 ,，“ 仅 包含 文本 ”可 不 是 你 想象 中 的 那样 ， 文 本 其 实 具有 很 多 类 型 ， 它 可 以 是 内 置 数据 类 
型 ， 也 可 以 是 自 定义 的 类 型 。 

声明 简易 元 素 的 语法 如 下 : 


<xs:element name=" 名 称 "” type=" 数 据 类 型 "/> 


< 全 一 


此 处 ，name 指 元 素 的 名 称 ，type 指 元 素 的 类 型 。XSD 拥有 很 多 内 置 数据 类 型 ， 表 4-1 就 


向 我 们 展示 了 常用 的 几 个 内 置 数据 类 型 。 


表 4-1 常用 的 内 置 数据 类 型 


身高 、 体 重 、 学 历 和 爱好 等 。 如 下 所 示 


数据 类 型 说 明 

string 字符 串 型 
decimal 十 进 制 数 型 ， 包 含 任意 精度 和 位 数 
int 有 正 负 的 32 位 整数 
integer 整 型 
float 标准 的 32 位 浮 点 数 ， 如 11.87 
byte 有 正 负 的 8 位 整数 
boolean 布尔 型 ， 元 素 只 能 取 tue、false、1( 表 示 true) 或 者 0( 表 示 false) 
date 日 期 型 ， 格 式 为 YYYY-MM-DD 
month 日 期 型 ， 格 式 为 YYYY-MM 

ear 年 份 日 期 型 ， 格 式 为 YYYY 
time 时 间 型 ， 格 式 为 HH:MM:SS 
datetime 日 期 时 间 型 ， 其 形式 为 YYYY-MM-DD hh:mm:ss 
anyURI 元 素 包 含 一 个 URL 


假设 要 创建 一 个 用 于 描述 个 人 档案 信息 的 XML 文档 ， 应 该 包括 姓名 、 出 生日 期 、 性 别 、 
为 定义 好 的 XML 元 素 : 


< 姓名 > 祝 红 涛 </ 姓 名 > 

< 出 生日 期 >1990-10-10</ 出 生日 期 > 

< 性 别 >1</ 性 别 > 

< 婚 否 >false</ 婚 否 > 

< 身高 >1.75</ 身 高 > 

< 体重 >65</ 体 重 > 

< 星座 > 狮子 座 </ 星 座 > 

< 血型 >B</ 血 型 > 

< 学 历 > 本 科 </ 学 历 > 

< 爱好 > 篮球 、 唱 歌 、 阅 读 和 旅行 </ 爱 好 > 
< 网 站 >http://www.itzcn.com</ 网 站 > 


可 以 看 到 ， 在 这 个 XML 文档 中 除了 普通 的 文本 型 内 容 外 ， 还 有 日 期 型 、 数 字 型 、 布 尔 型 


以 及 URL 类 型 内 容 。 


针对 这 个 XML 文档 , 我 们 可 以 使 用 XSD 的 简易 元 素来 定义 档案 信息 中 各 个 选项 的 数据 类 


型 。 例 如 ， 出 生日 期 必须 为 日 期 而 且 格式 必须 为 “年 -月 -日 ”; 性 别 只 能 为 “0” 或 者 “1”; 


等 等 


Ed >> 


如 下 所 示 为 最 终 定义 好 的 XSD 简易 元 素 : 


<xs:element name=" 姓 名 " type="xs:string"/> 
<xs:element name=" 出 生日 期 " type="xs:date"/> 
<xs:element name=" 性 别 " type="xs: boolean "/> 
<xs:element name=" 婚 否 " type="xs:boolean"/> 
<xs:element name=" 身 高 " type="xs:decimal"/> 
<xs:element name=" 体 重 " type="xs:integer"/> 


<xs:element name=" 星 座 " 
<xs:element name=" 血 型 " 
<xs:element name=" 学 历 " 
<xs:element name=" 爱 好 " 
<xs:element name=" 网 站 " 


type="xs: 
type="xs: 
type="xs: 
type="xs: 
type="xs: 


string"/> 
string"/> 
string"/> 
string"/> 
anyURI"/> 
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另外 ， 简 易 元 素 还 可 以 有 默认 值 和 固定 值 。 当 元 素 没有 被 指定 其 他 的 值 时 ， 默 认 值 将 被 自 


动 赋 给 元 素 。 如 下 例 所 示 : 


<xs:element name=" 性 别 " type="xs: boolean " default="1"/> 


我 们 用 “1” 和 “0” 来 分 别 表示 性 别 “ 男 ”和 “ 女 ”， 默 认 值 “1” 表 示 如 果 没 有 给 元 素 


“性 别 ” 赋 值 ， 默 认 的 值 为 “1” 
固定 值 同样 是 自动 赋 给 元 素 的 , 同时 固定 值 被 赋予 后 将 无 法 给 元 素 赋 其 他 值 。 如 下 例 所 示 : 


<xs:element name=" 性 别 " type="xs: boolean " fixed="1"/> 


性 别 被 赋予 固定 值 “1”， 表 示 性 别 的 值 将 会 是 表示 男 的 “1”， 且 无 法 改变 。 


4.2.2 ”实例 描述 


在 本 节 中 ,我们 学 习 了 如 何 定义 简易 元 素 ， 以 及 如 何 根据 XML 文件 来 创建 XSD 文件 。 现 
在 ， 我 们 通过 一 个 实例 来 加 深 对 简易 元 素 的 理解 。 在 本 实例 中 ， 我 们 将 为 简易 元 素 应 用 更 多 的 


内 置 数 据 类 型 。 


4.2.3 ”实例 应 用 


【 例 4-1】 根据 XML 文件 定义 简易 元 素 
(1) 新 建 一 个 XML 文件 ， 其 代码 如 下 : 


<?xml] version="1.0" encoding="utf-8"?> 


<information > 
<name>Harry</name> 
<age>10</age> 
<sex>1</sex> 
<like> 看 书 </1like> 


<birthday>2000-01-01</birthday> 
<timeout>10:10:00</timeout> 


<ismarry></ismarry> 
</information> 


(2) 将 文档 保存 为 XML 文件 格式 ， 名 称 为 “4- 例 1.xml”。 
(3) 接 下 来 就 是 创建 XSD 文件 。 在 VS 2010 中 打开 该 文件 ， 再 执行 XML | 【创建 架构 】 
命令 可 以 自动 生成 XSD 文件。 当然 也 可 以 手动 创建 ， 最 终 的 代码 如 下 所 示 : 


<?xml] version="1.0" encoding="utf-8"?> 


<xs:schema xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
attributeFormDefault="unqualified" elementFormDefault="qualified"™ 


xmlns:xs="http://www.w3.0org/2001/XMLSchema"> 


< 


@,. 服务 开发 学 习 实录 ， 


<xs:element name="information"> 
<xs:complexType> 
<xs:sequence> 
<xs:element name="name" type="xs:string" /> 
<xs:element name="age" type="xs:unsignedByte" /> 
<xs:element name="sex" type="xs:unsignedByte" /> 
<xs:element name="like" type="xs:string" /> 
<xs:element name="birthday" type="xs:date" /> 
<xs:element name="timeout" type="xs:time" /> 
<xs:element name="ismarry" /> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 


</xs:schema> 


(4) 可 以 看 到 ， 自 动 生成 的 XSD 文件 中 为 简易 元 素 指定 的 数据 类 型 与 实际 所 期 望 的 有 一 
定 差异 。 因 此 ， 这 一 步 在 此 基础 上 进行 修改 。 如 下 所 示 为 修改 后 各 个 XSD 元 素 的 类 型 : 


<xs:element name="name" type="xs:string" /> 
<xs:element name="age" type="xs:byte" /> 
<xs:element name="sex" type="xs:boolean" /> 
<xs:element name="like" type="xs:string" /> 
<xs:element name="birthday" type="xs:date" /> 
<xs:element nam timeout" typ 
<xs:element name="ismarry" type= 


(5) 现在 ，XML 文件 以 及 使 用 的 XSD 架构 文件 都 创建 完成 了 。 但 是 ， 两 者 并 没有 建立 任 
何 关联 。 如 果 在 XML 文件 要 引用 XSD 架构 ， 还 需要 添加 如 下 代码 : 


<information xmlns:xXsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:noNamespaceSchemaLocation="4- 例 1.xsd"> 


xs:time" /> 


xs:boolean" default="false" /> 


4.2.4 ”运行 结果 


将 XML 文件 和 XSD 文件 在 浏览 器 中 打开 ， 如 图 4-1 和 图 4-2 所 示 。 


FMUI\4 -ML xsd - Vindovs Internet Erplorer 


Fe\ 代 玛 \- 例 1. xnl - Winiows TInternet Frplorer 


GO rem 
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GO Erwan 
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Prml version="1.0" encoding=utF 有 ?> 
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ame>Hary dname> 
<age>10</age> 
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<timeout>10:10:00</timeout> 
emary /> 
<infomaton> 


com varsioncl orencodng=utfe 7> 
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4-1 XML 文档 


4-2 XSD 文档 
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4.2.5 ”实例 分 析 


Or 


为 了 表示 一 个 文件 为 XSD 架构 文件 ， 必 须 以 “.xsd” 为 扩展 名 进行 保存 。 还 需要 指定 
http://www.w3.org/2001/XMLSchema 作为 命名 空间 ， 并 添加 一 个 别名 引用 ， 一 般 使 用 “xs” 或 
者 “xsd” 。 

本 实例 中 的 XML 文档 比较 简单 ,没有 包含 子 元 素 或 者 属性 。 因 此 在 XSD 架构 中 使 用 简易 
元 素 就 可 以 完成 ， 但 是 要 注意 适当 安排 元 素 的 数据 类 型 。 

最 后 ， 在 XML 文档 中 使 用 xsi:noNamespaceSchemaLocation 引用 XSD 架构 文件 时 要 注意 
它们 的 物理 保存 路 径 在 同一 目录 下 。 


4.3 ”实现 图 书 分 类 的 XSD 


除了 上 节 介绍 的 XSD 内 置 数据 类 型 外 ，XSD 还 允许 开发 人 员 自 定义 与 应 用 程序 相关 的 数 
据 类 型 ， 因 而 扩展 了 XSD 的 数据 类 型 库 ， 并 增强 了 XSD 应 用 的 灵活 性 。 
根据 数据 类 型 的 定义 方式 ，W3C XSD 主要 可 分 为 两 种 : 简单 类 型 和 复杂 类 型 。 本 节 我 们 


E 视频 教学 : 光盘 /videos/04/ 实 现 图 书 分 类 avi @ 庆 17 分 名 


4.3.1 基础 知识 一 一 定义 简单 数据 类 型 


通常 情况 下 ，XML 中 的 元 素 会 包含 属性 ， 有 时 还 会 包含 纯 文 本 或 者 子 元 素 。 如 果 一 个 元 
素 仅仅 包含 数字 、 字 符 串 或 其 他 文本 数据 ， 但 不 包括 子 元 素 和 属性 ， 那 么 这 种 元 素 被 称 为 简单 

例如 ， 下 面 通 过 描述 手机 信息 的 XML 文档 形象 地 说 明 XSD 中 简单 类 型 与 复杂 类 型 的 
区 别 。 


< 手机 > 

<!-- 这 是 一 个 包含 属性 的 复杂 类 型 的 元 素 --> 

< 型 号 品牌 ="NOKIA">1100</ 型 号 > 

<!-- 这 是 一 个 包含 子 元 素 的 复杂 类 型 的 元 素 --> 

< 主要 参数 > 

< 体积 >113X43.5X15.5mm </ 体 积 > 

< 通话 时 间 >408 分 钟 </ 通 话 时 间 > 

< 屏幕 参数 >26 万 色 TFT 彩色 ; 240X320 像素 ;2 .0 英寸 </ 屏 幕 参数 > 
</ 主 要 参数 > 

<!-- 这 是 一 个 简单 类 型 的 元 素 --> 


< 


< 网 络 频率 >GSM/GPRS/VEDGE</ 网 络 频率 > 
</ 手 机 > 
简 而 言 之 ， 简 单数 据 类 型 就 是 在 XSD 内 置 数据 类 型 基础 上 ， 通 过 限制 基 类 型 、 列 表 或 者 
联合 的 方式 定义 的 新 数据 类 型 。 
XSD 简单 类 型 由 simpleType 关键 字 声明 ， 其 语法 格式 如 下 : 
<simpleType name =elementName id = elementId > 
<annotation|restriction | list | union>... 
</simpleType> 
语法 中 各 参数 的 定义 如 下 。 
@ name: 类 型 名 称 ， 该 名 称 必须 是 在 XML 命名 空间 规范 中 定义 的 无 冒号 名 称 。 
@ id: 该 元 素 的 ID。 id 值 必须 属于 类 型 ID 并 且 在 包含 该 元 素 的 文档 中 是 唯一 的 ， 它 是 
可 选项 。 
@ 包含 内 容 列表 : 可 以 在 简单 类 型 中 定义 的 元 素 类 型 ， 如 表 4-2 所 示 。 
表 4-2 简单 类 型 元 素 


annotation | 定义 批注 ， 用 来 对 XSD 文档 中 某 一 部 分 进行 说 明 


restriction ”| 为 简单 类 型 定义 一 个 约束 属性 ， 即 限制 基 类 型 
定义 简单 类 型 为 列表 类 型 
定义 简单 类 型 为 联合 类 型 


1. 限制 类 型 


通过 限制 类 型 ， 可 以 从 XSD 的 内 置 数据 类 型 中 继承 ， 并 添加 一 些 约束 条 件 形成 一 个 新 的 
类 型 ， 并 且 可 以 重复 使 用 。 
例如 ， 在 实际 应 用 的 数据 库 中 ， 对 用 户 名 称 的 长 度 通常 是 有 限制 的 ， 例 如 最 长 20 个 字符 。 
而 XSD 的 内 置 类 型 string 则 没有 这 个 限制 ， 所 以 这 种 类 型 用 在 这 种 场合 就 不 大 合适 。 但 是 ， 
可 以 从 string 类 型 继承 一 个 新 的 类 型 ， 并 添加 最 大 长 度 为 20 的 限制 ， 代 码 如 下 所 示 : 
<xs:element name=" 用 户 名 称 ”> 
<xs:simpleType > 
<xs:restriction base="xs:string"> 
<xs:maxLength value="20"/> 
</xs:restriction> 
</xs:simpleType> 
</zxs:element> 
在 这 个 示例 中 ， 我 们 从 string 类 型 通过 受 限 继承 的 方式 将 定义 的 新 的 简单 类 型 应 用 到 “用 
户 名 称 ” 元 素 上 。restriction 元 素 可 以 包含 一 个 或 者 多 个 子 元 素来 限制 基 类 型 .这 里 的 maxLength 
元 素 表示 限制 的 条 件 为 最 大 长 度 。 
例如 ， 下 面 的 示例 代码 限制 “用 户 名 称 ” 的 值 应 该 是 长 度 在 6 一 20 之 间 的 字符 串 。 
<xs:element name=" 用 户 名 称 ”> 
<xs:simpleType > 
<xs:restriction base="xs:string"> 
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<xs:maxLength value="20"/> 
<xs:minLength value="6"/> 
</xs:restriction> 
</xs:simpleType> 
</xs:element> 
restriction 元 素 还 包含 一 个 很 常用 的 enumeration 元 素 ， 该 元 素 可 以 将 内 容 限制 为 一 组 可 选 
择 的 值 ， 也 就 是 枚 举 限制 。 
下 面 的 例子 定义 了 带 有 -个 限制 的 名 为 “usersType” 的 元 素 ， 该 元 素 的 取 值 可 以 是 “新 手 
上 路 ”、“ 注 册 会 员 ”、“ 人 金牌 会 员 ” 或 者 “论坛 元 老 ” 之 - 
<xs:simpleType name="usersTYPe"> 
<xs:restriction base="xs:string"> 
<xs:enumeration value=" 新 手 上 路 "/> 
<xs:enumeration value=" 注 册 会 员 "/> 
<xs:enumeration value=" 人 金牌 会 员 "/> 
<xs:enumeration value=" 论 坛 元 老 "/> 
</xs:restriction> 
</xs:simpleType> 


接 下 来 ， 便 可 以 将 usersType 类 型 应 用 到 元 素 上 ， 下 面 代码 应 用 到 了 “会 员 级 别 ” 元 素 上 。 
<xs:element name=" 会 员 级 别 " type="usersType"/> 
这 里 对 限制 长 度 的 maxLength 元 素 、minLength 元 素 以 及 枚 举 enumeration 元 素 进行 了 简单 
介绍 。 其 实 ，restriction 中 还 可 以 包含 更 多 的 限制 条 件 ， 例 如 限制 数值 位 数 、 限 制 字符 串 范 围 
等 ， 如 表 4-3 所 示 给 出 了 这 些 元 素 及 其 描述 。 
表 4-3 restriction 常用 限制 元 素 


限定 元 素 描 述 

enumeration 定义 可 接受 值 的 一 个 列表 

fractionDigits | 定义 所 允许 的 最 大 的 小 数位 数 ， 应 用 于 继承 自 decimal 的 数据 类 型 
定义 类 型 值 的 固定 长 度 。 该 值 的 长 度 单位 依赖 于 基 类 型 ， 对 于 string 类 型 来 说 ， 单 位 是 字 
length 符 ， 对 于 hexBinary 和 Base64Binary 来 说 ,单位 是 8 个 字 节 。 对 于 通过 列表 继承 的 类 型 来 
说 ， 长 度 是 列表 中 单元 的 个 数 

maxExclusive | 定义 排除 时 数值 的 上 限 ， 即 所 定义 类 型 的 值 必须 小 于 此 值 

ImaxInclusive 定义 允许 时 数值 的 上 限 ， 即 所 定义 类 型 的 值 必须 小 于 或 等 于 此 值 

maxLength 定义 所 允许 的 字符 或 者 列表 项 目的 最 大 长 度 

minExclusive | 定义 排除 时 数值 的 下 限 ， 即 所 定义 类 型 的 值 必须 大 于 此 值 

IminInclusive 定义 允许 时 数值 的 下 限 ， 即 所 人 允许 类 型 的 值 必须 大 于 或 等 于 此 值 

minLength 定义 所 允许 的 字符 或 者 列表 项 目的 最 小 长 度 

Pattem 定义 所 允许 值 应 该 遵循 的 表达 式 模式 

totalDigits 定义 所 允许 数字 的 最 大 个 数 
定义 空白 字符 (换行 、 回 车 、 空 格 以 及 制 表 符 ) 的 处 理 方式 ， 可 选 值 有 : preserve、replace 
whiteSpace 和 collapse。preserve 表示 保留 空白 符 ，replace 表示 所 有 空白 都 使 用 空格 代替 ，collapse 表 
示 首 先进 行 replace 操作 ， 再 把 连续 空格 用 一 个 空格 代替 ， 并 删 掉 开头 和 结尾 的 空格 


< 


2. 列表 类 型 


列表 类 型 是 指 用 空格 隔 开 的 内 置 数据 类 型 列表 。 列 表 类 型 使 用 xs:list 声明 ，itemType 属性 
用 于 指定 元 素 的 数据 类 型 及 列表 内 容 。 然 后 ,在 元 素 声 明 中 引用 该 列表 类 型 。 下 面 给 出 的 XSD 
架构 示例 就 显示 了 内 置 数据 类 型 和 列表 类 型 的 用 法 。 

例如 ， 给 出 世界 上 的 部 分 旅游 景点 名 称 ， 形 成 一 个 列表 ， 然 后 在 XML 文档 显示 列表 中 属 
于 中 国 景点 的 景点 名 称 ， 其 XSD 架构 文件 如 下 所 示 : 


<xs:schema xmlns:Xs="http://www.w3.org/2001/XMLSchema"> 
<xs:simpleType name=" 景 点 "> 
<xs:restriction base="xs:string"> 
<xs:enumeration value=" 泰 山 日 出 "/> 
<xs:enumeration value=" 桂 林山 水 "/> 
<xs:enumeration value=" 雅 典 卫 城 "/> 
<xs:enumeration value=" 爱 琴海 "/> 
<xs:enumeration value=" 长 江 三 峡 "/> 
</xs:restriction> 
</xs:simpleType> 
<xs:simpleType name=" 世 界 景点 "> 
<xs:1ist itemType=" 景 点 "” /> 
</xs:simpleType> 
<xs:simpleType name=" 中 国 景点 "> 
<xs:restriction base=" 世 界 景点 "> 
<xs:length value="3" /> 


</xs:restriction> 
</xs:simpleType> 
<xs:element name=" 景 点 名 称 ”type=" 中 国 景点 ” /> 
</xs:schema> 
在 该 XSD 文档 中 ， 第 一 行 是 XSD 标准 声明 ， 其 中 xmlns 指定 了 该 XSD 包含 的 命名 空间 ， 
文档 中 还 定义 了 限制 类 型 景点 和 列表 类 型 景点 。 在 内 置 数据 类 型 定义 中 ,xs:simpleType 声明 这 
是 一 个 包含 简单 类 型 元 素 的 文档 。xs:restriction 是 一 个 限制 基 类 型 元 素 ， 它 可 以 限制 现 有 的 简 
单 类 型 的 值 以 满足 编写 文档 的 需要 ， 其 属性 base 指定 了 数据 类 型 为 string， 说 明 元 素 内 容 只 能 
包含 字符 串 。 在 元 素 景点 内 部 通过 枚 举 给 出 了 5 个 景点 名 称 ， 在 接 下 来 的 列表 类 型 定义 中 ， 列 
表 内 容 将 取 自 前 面 给 出 的 景点 。 
要 列 出 “中 国 景点 ”的 景点 名 称 ， 在 定义 的 简单 类 型 元 素 景点 名 称 中 ， 首 先 指定 其 基 类 来 
自 列表 类 型 “世界 景点 ”， 然 后 指定 其 可 以 包含 三 个 值 ， 最 后 ， 声 明 XML 文档 元 素 景点 名 称 ， 
其 值 类 型 为 “中 国 ”。 引 用 该 XSD 架构 的 XML 文档 如 下 : 
<?xml version="1.0" encoding="UTF-8"?> 
< 中 国 景点 xmlns:xs="http://www.w3.org/2001/xMLSchema-instance" 
xs:noNamespaceSchemaLocation="jingdian.xsd"> 
泰山 日 出 桂林 山水 长 江 三 峡 
</ 中 国 景点 > 


运行 该 XML 文档 ， 并 对 文档 进行 有 效 性 检查 ， 如 图 4-3 所 示 。 
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3. 联合 类 型 


联合 类 型 的 值 可 以 是 内 置 类 型 ， 也 可 以 属于 列表 类 型 。 该 类 型 可 以 包含 多 个 内 置 数据 
类 型 或 多 个 列表 类 型 。 联 合 类 型 由 xs:union 声明 元 素 , 使 用 定义 要 包含 的 类 型 值 。 
下 面 给 出 的 XSD 架构 示例 就 显示 了 联合 类 型 的 用 法 : 
<?Xml version="1.0" encoding="utf-8"?> 
<xs:schema xmlns:xs="http://www.w3.0rg/2001/XMLSchema"> 


<xs:simpleType name=" 朝 代称 号 "> 
<xs:restriction base="xs:string"> 


<xs:enumeration value=" 汉 "/> 
<xs:enumeration value=" 宋 "/> 
<xs:enumeration value=" 清 "/> 
</xs:restriction> 
</xs:simpleType> 
<xs:simpleType name=" 建 立时 间 "> 
<xs:restriction base="xs:integer"> 
<xs:minIinclusive value="960" /> 
<xs:maxInclusive value="1644" /> 
</xs:restriction> 
</xs:simpleType> 
<xs:simpleType name=" 朝 代 "> 
<xs:1ist itemType=" 朝 代称 号 " /> 
</xs:simpleType> 
<xs:simpleType name=" 时 间 "> 
<xs:union memberTypes=" 朝 代 建立 时 间 "/> 
</xs:simpleType> 
<xs:element name=" 朝 代 ”type=" 时 间 ” /> 
</xs:schema> 


本 例 中 ， 联 合 类 型 元 素 “ 时 间 ” 包 含 了 一 个 integer 类 型 的 “建立 时 间 ” 和 一 个 列表 类 型 
的 “朝代 ”。 如 下 所 示 为 符合 该 架构 的 XML 文档 内 容 : 


< 朝代 > 宋 </ 朝 代 > 

< 朝代 >960</ 朝 代 > 
< 朝代 > 清 </ 朝 代 > 

< 朝代 >1644</ 朝 代 > 


4.3.2 ”实例 描述 
通过 本 节 的 学 习 ， 我 们 了 解 了 简单 类 型 又 可 以 定义 为 三 种 : 限制 类 型 、 列 表 类 型 和 联合 类 


< 


型 ， 以 及 这 些 类 型 要 怎样 声明 ， 这 些 知 识 只 有 通过 不 断 的 实践 才能 熟练 掌握 和 应 用 。 


图 书馆 里 的 书 那么 多 ,要 想 找到 某 一 本 书 是 很 难 的 ， 于 是 图 书 管理 员 根 据 图 书 的 用 途 将 图 


书 分 门 别 类 。 这 样 ， 我 们 要 找 书 是 不 是 就 容易 多 了 。 按 照 这 种 思路 ， 我 们 运用 今天 学 习 的 三 种 
类 型 ， 也 将 我 们 的 图 书 分 分 类 吧 。 


4.3.3 ”实例 应 用 


【 例 4-2】 实现 图 书 分 类 的 XSD 
(1) 新 建 一 个 XSD 文件 ， 命 名 为 “4- 例 2.xsd”。 
(2) 利用 所 学 的 知识 ， 在 XSD 文件 中 定义 图 书 列表 、 价 格 列表 和 图 书 分 类 。 最 终 代 码 如 


下 所 示 : 


<xs:schema xmlns:xs="http://www.w3.0rg/2001/XMLSchema"> 
<xs:simpleType name= 书 "> 
<xs:restriction base="xs:string"> 
<xs:enumeration value="Web 开发 与 应 用 "/> 
<xs:enumeration value=" 教 你 如 何 学 编程 "/> 
<xs:enumeration value="C# 精 编 "/> 
<xs:enumeration value="ASP.NET 实战 "/> 
</xs:restriction> 
</xs:simpleType> 
<xs:simpleType name= "价格 "> 
<xs:restriction base="xs:double"> 
<xs:enumeration value="39.5"></xs:enumeration> 


<xs:enumeration value="45.0"></xs:enumeration> 
<xs:enumeration value="23.2"></xs:enumeration> 
</xs:restriction> 
</xs:simpleType> 


<xs:simpleType name=" 工 具 书 "> 
<xs:1ist itemType=" 图 书 " /> 
</xs:simpleType> 
<xs:simpleType name=" 报 价 "> 
<xs:union memberTypes=" 工 具 书 价格 "> 
</xs:union> 
</xs:simpleType> 
<xs:element name=" 图 书 名 称 ”type=" 报 价 ” /> 
</xs:schema> 


(3) 创建 一 个 XML 文件 与 XSD 在 同一 目录 下 ， 命 名 为 “4- 例 2.xml”。 
(4) 在 XML 中 声明 文档 根 元 素 为 “图 书 名 称 ”, 它 采 用 的 值 类 型 是 “报价 ”, 并 引用 XSD 。 


最 终 的 XML 文档 代码 如 下 : 


mi >> 


<?xml version="]1.0" encoding="utf-8"?> 
< 图 书 名 称 xmlns:xs="http://www.w3.org/2001/XxXMLSchema-instance" 


xs:noNamespaceschemaLocation=" 4- 例 2.xsd"> 


教 你 如 何 学 编程 AsP .NET 实战 c# 精 编 
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</ 图 书 名 称 > 
(5) 保存 对 XML 文档 的 修改 ， 实 例 就 完成 了 。 


4.3.4 运行 结果 
在 Web 中 运行 该 XML 文档 ， 并 对 XML 文档 进行 有 效 性 检查 ， 如 图 4-4 所 示 。 
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图 4-4 XSD 简单 类 型 


4.3.5 ”实例 分 析 


ee 


在 本 实例 中 ，XSD 文件 的 第 一 行 指定 了 该 XSD 引用 的 命名 空间 。 我 们 定义 了 限制 类 型 的 
“图 书 ” 和 “价格 ”， 在 元 素 图 书 内 通过 枚 举 给 出 了 4 本 图 书 的 名 称 。 列 表 类 型 “工具 书 ” 的 
内 容 将 取 自前 面 给 出 的 图 书 ，“ 报 价 ” 则 指定 为 联合 类 型 。 

要 注意 : XML 和 XSD 引用 的 命名 空间 不 同 ， 其 中 XSD 引用 的 命名 空间 为 
“http://www.w3.org/2001/XMLSchema”; XML 引用 的 命名 空间 为 “http://www.w3.org/2001/ 
XMLSchema-instance” 


4.4 定义 匿名 类 型 
严格 来 说 ,匿名 类 型 不 属于 一 种 特定 的 数据 类 型 。 它 只 是 在 定义 元 素 类 型 时 的 一 种 编写 方 
式 ， 下 面 我 们 就 来 了 解 一 下 匿名 类 型 的 定义 方法 。 
上 视频 教学 ; 光盘 /videos/04/ 匿 名 类 型 .avi 人 @@ 长 度 : 3 分 钟 


在 前 面 的 例子 中 ， 每 个 定义 的 类 型 都 有 唯一 的 名 称 。 例 如 ， 如 下 代码 定义 了 一 个 名 为 
“password” 的 简单 类 型 。 


<xs:simpleType name="password"> 


<xs:restriction base="xs:string"> 
<xs:pattern value="[a-zA-20-9] {8}"/> 
</xs:restriction> 
</xs:simpleType> 


< 全 一 


password 类 型 可 接受 的 值 是 由 8 个 字符 组 成 的 一 行 字符 , 而 且 这 些 字符 必须 是 大 写 或 小 写 
字母 a~z 或 者 数字 0 一 9。 

这 样 一 来 ，password 类 型 就 可 以 在 XSD 中 多 次 使 用 。 而 且 应 用 该 类 型 的 元 素 可 以 出 现在 
类 型 定义 之 前 或 者 之 后 , 相对 位 置 并 不 重要 .例如 , 如 下 的 代码 定义 “密码 ”元 素 的 值 为 password 
类 型 : 


<xs:element name=" 密 码 " type="password”" /> 


但 是 , 为 类 型 定义 一 个 名 称 并 不 是 必需 的 。 我 们 可 以 将 类 型 的 定义 作为 元 素 声明 的 一 部 分 ， 
而 无 须 再 为 类 型 定义 名 称 。 我 们 将 这 种 情况 下 声明 的 类 型 称 为 匿名 类 型 。 
例如 ， 下 面 是 采用 匿名 类 型 声明 密码 元 素 的 代码 : 
<xs:element name=" 密 码 "> 
<xs:simpleType > 
<xs:restriction base="xs:string"> 
<xs:pattern value="[a-zA-20-9] {8}"/> 
</xs:restriction> 
</xs:simpleType> 
</xs:element> 
在 这 个 例子 中 ，element 元 素 的 声明 没有 type 属性 ， 而 且 simpleType 类 型 中 也 没有 name 
属性 。 如 果 文 档 中 只 有 一 处 会 出 现 某 个 元 素 的 声明 ， 则 可 以 使 用 这 样 的 匿名 类 型 定义 。 
当然 ， 复 杂 类 型 也 可 以 用 相同 的 方法 来 定义 匿名 类 型 ， 例 如 下 面 给 出 的 示例 代码 。 
<xs:element name=" 主 要 参数 "> 
<xs:complexType> 
<xs:sequence> 
<xs:element name=" 体 积 " type="xs:string" /> 
<xs:element name=" 通 话 时 间 " type="xs:string" /> 
<xs:element name=" 屏 幕 参数 " type="xs:string" /> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 


4.5 专辑 信息 


参照 4.3.1 节 讲 解 简单 类 型 时 描述 手机 信息 的 XML 文档 。 我 们 可 以 了 解 到 , 复杂 类 型 不 仅 
可 以 包含 字符 内 容 ， 还 可 以 包含 子 元 素 和 元 素 属性 。 现 在 ， 就 让 我 们 来 好 好 学 习 一 下 吧 。 

复杂 类 型 可 以 包含 子 元 素 和 属性 ， 而 简单 类 型 则 不 能 。 简 单 类 型 通常 用 来 表示 大 多 数 平台 
所 支持 的 基础 数据 类 型 ， 像 整 型 、 字 符 串 、 日 期 和 时 间 以 及 布尔 ， 而 复杂 类 型 则 用 来 表示 数组 、 
集合 、 结 构 和 自 定 义 的 类 型 。 


Pp 
es 视频 教学 : 光盘 /videos/04/ 专 辑 信息 .avi @@ 长 度 : 15 分 钟 
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4.5.1 ”基础 知识 一 一 复杂 数据 类 型 


在 XSD 中 将 包含 子 元 素 和 元 素 属性 的 元 素 称 为 复杂 类 型 。 复 杂 类 型 根据 包含 的 内 容 ， 可 


以 分 为 4 种 : 简单 类 型 、 纯 元 素 类 型 、 混 合 类 型 和 空 类 型 。 


复杂 类 型 由 complexType 定义 ， 语 法 如 下 : 

<complexType name = 名 称 id = ID mixed = Boolean : false > 
<annotation | simpleContent | complexContent | group | all | choice | sequence 

| attribute | attributeGroup | anyAttribute >.. 

</complexType> 

语法 中 各 个 参数 的 含义 如 下 。 

@ name: 复杂 类 型 的 名 称 ， 该 名 称 必须 是 在 XML 命名 空间 规范 中 定义 的 无 冒号 名 称 。 

@ id: 该 元 素 的 ID。id 值 必须 属于 类 型 ID 并 且 在 包含 该 元 素 的 文档 中 是 唯一 的 。 它 
是 可 选项 。 

@ ”mixed: 一 个 指示 符 ， 指 示 是 否 允 许字 符 数据 出 现在 该 复杂 类 型 的 子 元 素 之 间 。 默 认 
值 为 false 。 如 果 simpleContent 元 素 是 子 元 素 ， 则 不 允许 mixed 属性 。 如 果 
complexContent 元 素 是 子 元 素 , 则 该 mixed 属性 可 被 complexContent 元 素 的 mixed 属 


性 重 写 。 它 是 可 选项 。 
@ 包含 内 容 : 元 素 内 容 均 可 以 定义 在 复杂 类 型 中 ， 如 表 4-4 所 示 。 


表 4-4 复杂 类 型 元 素 


元 素 描 述 
annotation 批注 ， 只 在 XSD 中 起 注释 的 作用 ， 不 影响 整体 内 容 


simpleContent 


complexContent 


从 简单 类 型 派生 复杂 类 型 。 用 于 声明 包含 字符 内 容 和 属性 的 元 素 ， 但 不 包含 子 元 素 的 
声明 

从 复杂 类 型 派生 出 新 的 复杂 类 型 。 用 于 声明 包含 属性 和 子 元 素 的 元 素 声明 ， 但 不 包含 
字符 数据 的 元 素 声明 

将 若干 元 素 声明 归 为 一 组 ， 将 它们 作为 一 个 组 并 入 复杂 类 型 定义 


group 
all 表示 符合 元 素 声 明 的 所 有 元 素 都 应 该 出 现 且 只 能 出 现 一 次 
choice 用 来 声明 只 有 一 个 相 容 元 素 必须 出 现 ， 用 于 选择 情况 
定义 了 一 系列 元 素 并 且 必 须 按照 模式 中 定义 的 顺序 显示 ， 所 有 子 元 素 如 果 在 实例 文档 
ee 中 出 现 ， 则 必须 按照 访 顺 序 显示 
attribute 为 出 现 的 元 素 定义 属性 
attributeGroup 定义 属性 列表 
anyAttibute 在 XML 文档 中 添加 未 被 Schema 指定 过 的 属性 


下 面 我 们 给 出 一 个 XML 文档 ， 要 求 根据 该 文档 给 出 文档 的 XSD 架构 。XML 文档 代码 


如 下 : 


<?xm] version="].0" encoding="utf-8"?> 


< 作 一 


< 电影 xmlns:xs="http://www.w3.org/2001/xMLSchema-instance" 
xs:noNamespaceSchemaLocation="4-6-1.xsd" 
语言 =" 英 语 "> 
< 电影 名 imdb 编码 ="tt0209163"> 木 乃 伊 归来 </ 电 影 名 > 
< 主演 > 布 兰 登 。 弗 雷 泽 </ 主 演 > 
< 导演 > 斯 蒂 芬 。 索 莫 斯 </ 导 演 > 
< 简介 > 故事 发 生 在 1933 年 ， 也 就 是 蝎子 王 的 年 代 。 距 上 次 瑞 克 - 奥 克 康 纳 ( 布 兰 登 - 弗 雷 泽 饰 ) 和 无 
慢 的 埃及 考古 学 家 艾 弗 琳 ( 瑞 切 尔 - 薇 茨 饰 ) 奋力 与 3000 岁 的 “ 老 怪 ” 伊 默 特 普 ( 阿 诺 - 沃 斯 洛 饰 ) 作战 得 
以 逃生 ， 已 有 8 年 了 ……</ 简 介 > 
< 出 品 信息 > 
< 出 品 公司 > 环球 公司 </ 出 品 公司 > 
< 上 了 映 时 间 >2001-05-04</ 上 了 映 时 间 > 
</ 出 品 信息 > 
< 类 型 影片 类 型 =" 动 作 片 | 冒险 片 | 喜剧 片 | 爱情 片 | 科幻 片 | 恐怖 片 "> 
< 冒险 片 /> 
</ 类 型 > 
</ 电 影 > 


为 了 详细 说 明 复 杂 类 型 各 个 元 素 的 含义 及 用 法 ， 以 及 复杂 类 型 4 种 内 容 类 型 的 区 别 ， 下 面 
我 们 将 以 “电影 ”信息 为 例 详细 说 明 。 

1. 简单 类 型 

在 上 节 我 们 学 到 ， 简 单 类 型 只 包含 文本 的 元 素 ， 如 果 要 在 复杂 类 型 里 定义 简单 类 型 元 素 必 
须 添加 simpleContent 元 素 。 在 simpleContent 元 素 内 定义 扩展 或 限定 简单 类 型 元 素 , 语法 如 下 : 


<xs:element name=" 某 个 名 称 "> 
<xs:complexType> 
<xs:simpleContent> 
<xs:extension|restriction base="basetype"> 


</xs:extension|restriction> 
</xs:simpleContent> 
</xs:complexType> 
/xs:element> 


$ 在 定义 扩展 或 限定 简单 类 型 元 素 时 ， 必 须 使 用 extension 或 restriction。extension 
注意 | 元 素 表 示 对 simpleContent 的 扩展 ; restriction 元 素 表示 对 simpleContent 的 约束 。 


根据 该 定义 ， 我 们 可 以 给 出 “电影 ”的 部 分 XSD 文档 ， 如 下 所 示 : 


<xs:element name=" 电 影 名 "> 
<xs:complexType> 
<xs:simpleContent> 
<xs:extension base="xs:string"> 
<xs:attribute name="imdb 编码 " type="xs:string" /> 
</xs:extension> 


</xs:simpleContent> 


mt 读 )>> 
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</xs:complexType> 
</xs:element> 


在 此 实例 中 ,attribute 元 素 表示 为 出 现 的 元 素 定义 属性 ,“ 电 影 名 ”包含 属性 “imdb 编码 ”， 
所 以 为 复杂 类 型 。 但 是 元 素 中 不 再 包含 子 元 素 ， 而 只 包含 字符 数据 ， 所 以 可 以 用 simpleContent 
元 素 声 明 简单 类 型 内 容 。 我 们 使 用 extension 元 素 为 “电影 名 ”定义 属性 ， 表 示 对 “电影 名 ” 
进行 扩展 。 

2. 纯 元 素 类 型 


纯 元 素 类 型 ， 顾 名 思 义 就 是 仅 包含 元 素 的 元 素 类 型 。 如 下 所 示 XML 文档 中 ，“ 电 脑 ” 仅 
包含 了 4 个 纯 元 素 类 型 的 子 元 素 。 


< 电脑 > 
< 显示 器 > 三 星 </ 显 示 器 > 
< 主机 > 盘古 系列 </ 主 机 > 
< 鼠标 > 双飞 燕 </ 鼠标 > 
< 键盘 > 双飞 燕 </ 键 盘 > 
</ 电 脑 > 


相对 应 的 ， 在 XSD 中 的 定义 就 可 以 ， 如 下 所 示 : 


<xs:schema xmlns:xs="http://www.w3.0rg/2001/XMLSchema"> 
<xs:element name=" 电 脑 "> 
<xs:complexType> 


<xs:sequence> 
<xs:element name=" 显 示 器 " type="xs:string" /> 
<xs:element name=" 主 机 " type="xs:string" /> 
<xs:element name=" 和 鼠标 " type="xs:string" /> 
<xs:element name=" 键 盘 " type="xs:string" /> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
</xs:schema> 


在 该 XSD 文档 中 ，sequence 表示 定义 了 一 系列 元 素 并 且 必 须 按照 模式 中 指定 的 顺序 显示 。 
我 们 已 经 定义 了 “电脑 ”中 子 元 素 的 顺序 为 “显示 器 ”一 “主机 ”一 “鼠标 ”一 “键盘 ”。 在 
XML 文档 中 ， 这 些 子 元 素 如 果 出 现 ， 则 必须 按照 此 顺序 出 现 ， 否 则 ， 将 会 出 错 。 

<xs:element name=" 电 影 "> 

<xs:complexType> 
<xs:sequence> 
</xs:complexType> 
</zxs:element> 


于 是 ， 根 据 纯 元 素 类 型 的 特点 ， 我 们 给 出 了 “电影 ”的 部 分 XSD 文档 ， 如 下 所 示 : 


<xs:element name=" 电 影 "> 
<xs:complexType> 
<xs:sequence> 


< 人 


<xs:element name=" 主 演 " type="xs:string"/> 
<xs:element name=" 导 演 " type="xs:string"/> 
<xs:element name=" 简 介 " type="xs:string"/> 
</xs:element> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 


这 里 的 “主演 ”、“ 导 演 ” 和 “简介 ”都 是 作为 混合 类 型 中 的 纯 元 素 类 型 出 现 的 。 
3. 混合 类 型 


混合 类 型 包含 了 属性 、 元 素 及 文本 。 这 里 ， 我 们 通过 对 group、all 和 choice 的 讲解 来 学 习 
混合 类 型 的 使 用 方法 。 


D group 
group 元 素 是 将 若干 元 素 声明 归 为 一 组 ， 以 便 将 它们 当 作 一 个 组 并 入 复杂 类 型 定义 ， 如 下 
段 代码 所 示 : 


<?xml version="1.0" encoding="utf-8"?> 
<xs:schema xmlns:xs="http://www.w3.0rg/2001/XMLSchema"> 
<xs:element name=" 显 示 器 " type="xs:string" /> 
主机 " type="xs:string" /> 
<xs:element name=" 和 鼠标 " type="xs:string" /> 
<xs:element name=" 键 盘 " type="xs:string" /> 
<xs:attribute name=" 类 型 " type="xs:string" /> 
<xs:group name=" 配 件 "> 
<xs:sequence> 
<xs:element ref=" 显 示 器 "” /> 
<xs:element ref=" 主 机 " /> 
<xs:element ref=" 键 盘 " /> 
</xs:sequence> 
</xs:group> 
<xs:element name=" 电 脑 "> 
<xs:complexType> 
<xs:sequence> 
<xs:element name=" 配 件 "> 
<xs:complexType> 
<xs:group ref=" 配 件 " /> 
</xs:complexType> 
</xs:element> 


<xs:element nam: 


</xs:sequence> 
<xs:attribute ref=" 类 型 "/> 
</xs:complexType> 
</xs:element> 


</xs:schema> 


在 该 例 中 ， 使 用 group 将 “显示 器 ”、“ 主 机 ”和 “键盘 ” 归 为 一 个 组 ， 在 “配件 ”中 使 
用 ref 指向 该 组 。 


m= 二 > 
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根据 该 例 ， 可 以 知道 ，group 的 语法 如 下 : 


<group name= 名 称 id = ID maxOccurs= 数 值 minoccurs= 数 值 ref= 组 名 > 
<annotationlall | choice | sequence> ... 


</group> 


@ ”maxOccurs 和 minOccurs 分 别 是 允许 元 素 出 现 的 最 多 和 最 少 次 数 。 

@ ref 是 在 该 架构 (或 由 指定 的 命名 空间 指示 的 其 他 架构 ) 中 声明 的 组 的 名 称 。ref 值 必须 
是 组 名 称 。ref 可 以 包含 命名 空间 前 级 。 如 果 ref 属性 出 现 ， 则 id、minOccurs 和 
ImaxOccurs 可 以 出 现 。Ref 和 name 是 互相 排斥 的 。 

根据 XSD 文档 ， 我 们 可 以 得 到 XML 文档 ， 代 码 如 下 : 


< 电脑 类 型 =" 台 式 机 "> 
< 配件 > 
< 显示 器 / > 
< 主机 / > 
< 键盘 </ > 
</ 配 件 > 
</ 电 脑 > 


2) all 
all 元 素 表示 符合 元 素 声明 的 所 有 元 素 都 应 该 出 现 (以 任何 顺序 ) 且 只 能 出 现 一 次 all 的 语法 
结构 如 下 : 


<all id = ID maxOccurs= 数 值 minoccurs= 数值 > 
<annotation| element>... 
</all> 


如 下 列 代码 展示 了 all 的 用 法 : 


<xs:schema xmlns:XSs="http://www.w3.org/2001/XMLSchema"> 
<xs:element name=" 电 脑 "> 
<xs:complexType> 
<xs:all> 
<xs:element name=" 显 示 器 " type="xs:string" /> 
<xs:element name=" 主 机 " type="xs:string" /> 
<xs:element name=" 和 鼠标 " type="xs:string" /> 
<xs:element name=" 键 盘 " type="xs:string" /> 
</zxs:all> 
</xs:complexType> 
</xs:element> 
</zxs:schema> 


该 例 中 ， 使 用 all 定义 了 子 元 素 都 应 该 出 现 ， 并 且 只 能 出 现 一 次 ， 对 应 的 XML 文档 如 下 : 


< 电脑 > 
< 显示 器 > 三 星 </ 显 示 器 > 
< 主机 > 盘古 系列 </ 主 机 > 
< 键盘 > 双飞 燕 </ 键 盘 > 
< 鼠标 > 双飞 燕 </ 鼠 标 > 
</ 电 脑 > 


< 


< 服务 开发 学 习 实录 ， 


3) choice 


choice 用 来 声明 只 有 一 个 相 容 元 素 必须 出 现 ， 用 于 选择 情况 。 语 法 结构 如 下 : 


<choice id = ID maxOccurs= 数 值 minoccurs= 数 值 > 


<annotation | 
</choice> 


还 以 “电脑 ”为 例 ， 


element | group | choice | sequence | any> .. 


使 用 choice 元 素 为 电脑 进行 分 类 选择 ， 代 码 如 下 : 


<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"> 
<xs:element name=" 电 脑 "> 


<xs:complexType> 


<xs:all> 
<xs:element name=" 显 示 器 " type="xs:string" /> 
<xs:element name=" 主 机 " type="xs:string" /> 
<xs:element name=" 和 鼠标 " type="xs:string" /> 
<xs:element name=" 键 盘 " type="xs:string" /> 


<XS: 


element name=" 类 别 "> 
<xs:complexType> 
<xs:choice> 
<xs:element name=" 笔 记 本 " type="xs:string"/> 
<xs:element name=" 人 台式 机 " type="xs:string"/> 
<xs:element name=" 组 装机 " type="xs:string"/> 
</xs:choice> 
</xs:complexType> 


</xs:element> 
</xs:all> 
</xs:complexType> 


</xs:element> 
</xs:schema> 


我 们 使 用 choice 元 素 为 “电脑 ”的 子 元 素 “ 种 类 ”定义 了 三 个 选项 ， 在 XML 文档 中 必须 
选择 一 项 ，XML 文档 如 下 


<?xml version="1. 


0" encoding="utf-8"?> 


< 电脑 > 
< 显示 器 > 三 星 </ 显 示 器 > 
< 主机 > 盘古 系列 </ 主 机 > 
< 键盘 > 双飞 燕 </ 键 盘 > 
< 鼠标 > 双飞 燕 </ 鼠 标 > 
< 类 别 > 
< 组 装机 /> 
</ 类 别 > 
</ 电 脑 > 
人 空 类 型 


空 类 型 不 能 包含 内 容 ， 只 能 包含 属性 。 如 下 列 XML 表示 一 个 空 的 XML 元 素 : 
< 产品 型 号 编号 ="007" /> 
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上 面 的 “产品 型 号 ”除了 属性 “编号 ”外 ， 根 本 没有 内 容 。 为 了 定义 无 内 容 的 类 型 ， 我 们 
就 必须 声明 一 个 在 其 内 容 中 只 包含 属性 的 类 型 , 而 事实 上 我 们 不 需要 声明 任何 包含 其 他 内 容 的 
元 素 ，XSD 文档 如 下 所 示 : 


<xs:element name=" 产 品 型 号 "> 
<xs:complexType> 
<xs:attribute name=" 编 号 " type="xs:positiveInteger"/> 
</xs:complexType> 
</xs:element> 


该 例 中 ， 我 们 定义 了 名 为 “产品 型 号 ”的 复合 类 型 ， 并 且 声明 了 “编号 ”属性 ， 且 没有 任 
何 元 素 内 容 。 

到 了 这 里 ， 复 杂 类 型 的 知识 已 经 学 习 完 毕 了 。 那 么 ， 对 于 本 章节 开始 的 “电影 ”实例 ， 根 
据 提供 的 XML 文档 得 到 相应 的 XSD 文档 也 不 是 难事 了 ， 代 码 如 下 : 


<?xml Version="1.0"” encoding="utf-8"?> 
<xs:schema xmlns:xs="http://www.w3.0org/2001/XMLSchema"> 
电影 "> 
<xs:complexType> 
<xs:sequence> 
<xs:element name=" 电 影 名 "> 
<xs:complexType> 
<xs:simpleContent> 


<xs:element name= 


<xs:extension base="xs:string"> 


<xs:attribute name="imdb 编码 " type="xs:string" /> 
</xs:extension> 
</xs:simpleContent> 
</xs:complexType> 
</xs:element> 
<xs:element name=" 主 演 " type="xs:string"/> 
<xs:element xs:string"/> 
<xs:element name=" 简 介 " type="xs:string"/> 
<xs:element name=" 出 品 信 息 " minOccurs="0" maxOccurs="1"> 
<xs:complexType> 
<xs:sequence> 
<xs:element name=" 出 品 公司 " type="xs:string"/> 
<xs:element name=" 上 了 映 时 间 " type="xs:date"/> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
<xs:element name=" 类 型 "> 
<xs:complexType> 
<xs:choice> 


<xs:element name=" 动 作 片 " type="xs:string"/> 
<xs:element name=" 冒 险 片 " type="xs:string"/> 
type= 
type="xs:string"/> 


<xs:element xs:string"/> 
<xs:element 


<xs:element type="xs:string"/> 


<xs:element type="xs:string"/> 


< 全 一 


</xs:choice> 
<xs:attribute name=" 影 片 类 型 " type="xs:string" /> 
</xs:complexType> 
</xs:element> 
</xs:sequence> 
<xs:attribute name=" 语 言 " type="xs:string"/> 
</xs:complexType> 
</xs:element> 
</xs:schema> 


4.5.2 ”实例 描述 


我 们 都 喜欢 听 音 乐 ， 一 首 好 听 的 专辑 包含 的 信息 一 般 都 在 专辑 的 封面 上 。 今 天 ， 我 们 要 使 
用 XML 和 XSD 将 专辑 信息 表达 出 来 ， 使 之 更 加 生动 形象 。 


4.5.3 ”实例 应 用 


【 例 4-3】 专辑 信息 
(1) 新 建 一 个 名 为 “4- 例 3.XSD” 的 XSD 文件 ， 代 码 如 下 : 


<?xml Version="1.0"” encoding="utf-8"?> 
<xs:schema xmlns:XSs="http://www.w3.org/2001/XMLSchema"> 
<xs:element name=" 专 辑 "> 
<xs:complexType> 
<xs:sequence> 
<xs:element name=" 歌 曲名 " type: s:string"/> 
演唱 者 " type="xs:string"/> 
<xs:element name=" 作 词 " type="xs:string"/> 
<xs:element name=" 作 有 曲 " type="xs:string"/> 
<xs:element name="MV" minOccurs="0" maxOccurs 


<xs:element name= 


和 
<xs:complexType> 
<xs:all> 
<xs:element name=" 导 演 " type="xs:string"/> 
<xs:element name=" 主 演 " type="xs:string"/> 
二 /SS 
</xs:complexType> 
</xs:element> 
<xs:element name=" 类 型 "> 
<xs:complexType> 
<xs:choice> 
<xs:element name=" 摇 滚 " type="xs:string"/> 
<xs:element name="Hip-Hop" type="xs:string"/> 
电子 乐 " type="xs:string"/> 
古典 "” type="xs:string"/> 


<xs:element 


<xs:element name= 
</xs:choice> 
<xs:attribute name=" 歌 曲 类 型 " type="xs:string" /> 
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</zxs:complexType> 
</xs:element> 


</xs:sequence> 


<xs:attribute name=" 语 言 " type="xs:string"/> 


</xs:complexType> 
</xs:element> 
</xs:schema> 


(2) 新 建 一 个 XML 文档 ， 并 引用 XSD 文档 “4- 例 3”， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


< 专辑 xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" 


xs:noNamespaceSchemaLocation="4- 例 3.xsd" 
语言 =" 中 文 "> 
< 歌曲 名 > 半 城 烟 沙 </ 歌 曲名 > 
< 演唱 者 > 许 渍 </ 演唱 者 > 
< 作词 > 许 沿 </ 作词 > 
< 作曲 > 许 党 </ 作 曲 > 
<MV> 
< 导演 > 未 知 </ 导 演 > 
< 主演 > 未 知 </ 主 演 > 
</MV> 
< 类 型 歌曲 类 型 =" 摇 滚 1Hip-Hop1 电 子 乐 | 古典 "> 
< 古典 /> 
</ 类 型 > 
</ 专 辑 > 


(3) 保存 ， 并 将 XSD 文档 和 XML 文档 放 在 同一 目录 下 。 


4.5.4 ”运行 结果 


在 浏览 器 中 打开 XML 文档 和 XSD 文档 ， 效 果 如 图 4-5 所 示 。 


Fz\ 代 码 \4- 例 3. xml - Winiows Internet Explorer 


GO Erwanwp a 


会 收 京 天 。 | 习 F\ 代 三 W- 人 3_xal 


<axml version="1.0" encoding="utf-8" ?> 
- < 寺 辐 xmins:xs="http://www.w3.org/2001/XMLSchema-instance” 
xs:noNamespaceSchemaLocation="4- 例 3.xsd" 语言 =" 中 文 "> 
< 歌曲 名 > 半 城 姻 沙 </ 歌 曲 生 > 
< 演唱 者 > 许 </ 演 唱 者 > 
< 作词 > 许 迪 </ 作 词 > 
< 作曲 > 许 沉 </ 作曲 > 
- <Mv> 
< 导演 > 未 知 </ 导 演 > 
< 主演 > 未 知 </ 主 演 > 
</MV> 
-< 类 型 歌 此 类 型 = 反 溢 1Hip-Hop1 电 子 乐 | 古典 "> 
< 古典 /> 
</ 类 型 > 
专辑 > 


4-5 XML 文档 效果 


< 全 一 


4.5.5 ”实例 分 析 


i 


在 该 实例 中 ， 使 用 sequence 元 素 确保 声明 的 子 元 素 都 会 出 现在 XML 文档 中 。 使 用 all 元 
素 表示 符合 元 素 声明 的 元 素 只 能 出 现 一 次 。 使 用 choice 元 素 用 来 进行 选择 。 使 用 attribute 定义 
一 个 元 素 的 属性 。 


4.6 构造 XSD 的 元 素 和 属性 


前 面 的 小 节 中 对 XSD 的 两 种 数据 类 型 进行 了 详细 的 讲解 。 通 过 大 量 的 实例 ， 读 者 可 能 已 
经 掌握 了 XSD 文档 的 基本 构造 方法 。 本 节 将 对 XSD 架构 文档 中 的 细节 进行 介绍 ， 首 先是 如 何 
声明 一 个 元 素 。 


< 视频 教学 : 光盘 /videos/04/XSD 的 元 素 和 属性 .avi 加 长 度 : 12 分 钟 


4.6.1 基础 知识 一 一 声明 元 素 


在 一 个 XSD 文档 中 使 用 schema 来 声明 根 元 素 ， 根 元 素 指 定 文档 类 型 ， 包 括 模式 的 约束 、 
XML 模式 名 称 空间 定义 、 版 本 信息 和 语言 信息 等 。 

根 元 素 在 每 个 文档 中 只 能 出 现 一 次 。 要 声明 一 个 普通 元 素 需 要 使 用 element 来 定义 ， 它 可 
以 在 文档 中 出 现 多 次 。 

element 定义 元 素 的 详细 语法 格式 如 下 : 

<xsd:element abstract | block | default | final | fixed | form | id | maxOccurs 

| minOoccurs | name | nillable | ref | substitutionGroup | type > 

<xsd:annotation | xsd:simpleType | xsd:complexType | xsd:unique | 


xsd:key | xsd:keyref >.. 
</xsd:element> 


语法 中 ，abstract 和 block 等 是 element 元 素 的 属性 ， 在 表 4-5 中 给 出 了 这 些 属性 的 说 明 。 
表 4-5 ”element 元 素 的 属性 说 明 


属性 名 说 明 
abstract 一 个 boolean 型 的 值 ， 指 定 元 素 是 否 可 以 在 实例 文档 中 使 用 。 默 认 值 为 false 
block block 属性 用 于 防止 具有 指定 派生 类 型 的 元 素 蔡 代 该 元 素 
default 为 元 素 指定 一 个 默认 值 
final 设置 element 元 素 上 final 属性 的 默认 值 
fixed 为 元 素 指定 一 个 固定 值 ， 并 且 是 不 可 更 改 的 值 
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续 表 
属性 名 说 明 

指定 元 素 的 形式 .默认 值 是 schema 元 素 elementFormDefault 属性 的 值 , 必须 是 qualified 
form 或 者 unqualified。 如 果 该 值 是 非 限定 的 ， 则 无 须 通 过 命名 空间 前 级 限定 该 元 素 。 如 果 

该 值 是 限定 的 ， 则 必须 通过 命名 空间 前 缀 限定 该 元 素 
id 指定 元 素 的 IDP， 该 值 必须 属于 类 型 ID， 并 且 在 包含 该 元 素 的 文档 中 是 唯一 的 
maxOccurs 指定 元 素 可 以 在 包含 元 素 中 出 现 的 最 大 次 数 
minOccurs 指定 元 素 可 以 在 包含 元 素 中 出 现 的 最 小 次 数 
name 指定 元 素 的 名 称 
nillable 一 个 boolean 型 的 值 ， 指 定 是 否 可 以 将 显 式 的 零 值 分 配给 该 元 素 。 默 认 值 为 false 


在 架构 中 声明 元 素 的 名 称 。 该 值 必须 是 限定 名 称 ， 可 以 包含 命名 空间 前 组 

指定 可 用 来 蔡 代 该 元 素 的 元 素 名 称 。 该 元 素 必须 具有 相同 的 类 型 或 者 是 从 指定 元 素 类 
型 派生 的 类 型 

指定 元 素数 据 类 型 ， 该 数据 类 型 可 以 是 内 置 数据 类 型 ， 或 者 是 在 此 架构 中 定义 的 
simpleType 或 者 complexType 元 素 


下 面 ， 我 们 来 了 解 一 下 element 元 素 的 子 元 素 ， 其 中 一 些 在 前 面 已 经 用 过 ， 如 表 4-6 所 示 。 
表 4-6 element 元 素 的 子 元 素 说 明 


ref 


substitutionGroup 


type 


元 素 名 说 明 
annotation 定义 批注 
simpleType 定义 一 个 简单 类 型 
complexType 定义 一 个 复杂 类 型 
unique 指定 属性 或 者 元 素 值 在 指定 范围 内 必须 是 唯一 的 
指定 属性 或 者 元 素 值 必须 是 指定 范围 内 的 键 。 键 的 范围 为 实例 文档 中 包含 的 element。 
键 意味 着 数据 在 指定 范围 内 应 是 唯一 的 、 不 为 零 的 并 且 始 终 存在 的 
keyref 指定 属性 或 元 素 值 (或 一 组 值 ) 与 指定 的 key 或 unique 元 素 的 值 相对 应 


全 对 于 表 4-5 和 表 4-6 中 的 数据 ， 读 者 可 能 会 觉得 一 时 难以 理解 ， 其 实 列 出 element 
注意 元 素 全 部 的 属性 及 子 元 素 只 是 为 了 让 读者 有 一 个 初步 的 了 解 ， 以 方便 后 面 阅读 一 
此 复杂 的 Schema 文档 。 在 本 书 中 ， 也 只 用 到 了 一 些 比较 常用 的 属性 和 子 元 素 。 


例如 ， 我 们 有 一 个 保存 游戏 信息 的 XML 文档， 包括 游戏 类 型 、 名 称 、 开 发 者 和 版 本 ， 它 
的 内 容 如 下 所 示 : 
<2?xml version="1.0" encoding="utf-8"?> 
< 游戏 列表 > 
< 游戏 类 型 =" 益 智 类 "> 
< 名 称 > 推 箱子 </ 名 称 > 
< 开发 者 > 汇 智 科技 </ 开 发 者 > 
< 版 本 >1 .1.5.3RC</ 版 本 > 
</ 游 戏 > 


< 信 ——-_ 


< 游戏 类 型 =" 射 击 类 "> 
< 名 称 > 穿 越 火线 </ 名 称 > 
< 开发 者 > 昌 利 数 码 </ 开 发 者 > 
< 版 本 >2 .1.2RC</ 版 本 > 

</ 游 戏 > 

< 游戏 类 型 =" 休 闲 类 "> 
< 名 称 > 超级 大 富翁 </ 名 称 > 
< 开发 者 > 豆包 娱乐 </ 开 发 者 > 
< 版 本 >1 .0.6</ 版 本 > 

</ 游 戏 > 

</ 游 戏 列表 > 


在 这 个 XML 文档 中 ， 根 元 素 游戏 列表 只 有 一 个 游戏 子 元 素 ， 但 是 每 个 游戏 元 素 中 包含 的 
子 元 素 和 属性 都 不 同 。 游 戏 元 素 包含 的 子 元 素 有 名 称 、 开 发 者 和 版 本 ， 以 及 一 个 类 型 属性 。 
下 面 ,创建 相应 的 XSD 架构 文件 。 首 先 使 用 schema 定义 根 元 素 及 命名 空间 ， 然 后 针对 游 
戏 列 表 和 游戏 添加 相应 的 元 素 定义 语句 。 最 终 形成 的 完整 架构 如 下 所 示 : 


<?xml Version="1.0"” encoding="utf-8"?> 


<xs:schema xmlns:xs="http://www.w3.0org/2001/XMLSchema"> 
<xs:element name=" 游 戏 列表 "> 
<xs:complexType> 
<xs:sequence> 
<xs:element maxOccurs="unbounded"” name=" 游 戏 "> 
<xs:complexType> 
<xs:sequence> 
<xs:element name=" 名 称 " type="xs:string" /> 
<xs:element name=" 开 发 者 " type="xs:string" /> 
<xs:element name=" 版 本 " type="xs:string" /> 
</xs:sequence> 
<xs:attribute name=" 类 型 " type="xs:string" use="required"/> 
</xs:complexType> 
</xs:element> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
</zxs:schema> 


如 上 述 代码 所 示 ， 使 用 element 元 素 定 义 根 元 素 为 游戏 列表 。 另 外 ， 由 于 它 包含 有 子 元 素 
及 属性 ， 所 以 使 用 complexType 声明 为 复杂 类 型 ,然后 按照 元 素 在 文档 中 出 现 的 先后 顺序 进行 
再 往 下 定义 游戏 元 素 及 其 子 元 素 ， 还 有 类 型 属性 。 其 中 “maxOccurs="unbounded" ”定义 
游戏 元 素 至 少 出 现 一 次 ， 无 次 数 限制 。 类 型 属性 的 “use="required"” 表 示 在 XML 文档 中 必须 
出 现 ， 且 它 的 值 是 一 个 枚 举 值 。 如 下 定义 了 枚 举 数 据 类 型 的 “游戏 类 型 ”， 它 的 值 是 一 些 字符 
串 组 成 的 列表 : 


<xs:simpleType name=" 游 戏 类 型 "> 
<xs:restriction base="xs:string"> 


m2 >> 
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<xs:enumeration value=" 益 智 类 "/> 
<xs:enumeration value=" 射 击 类 "/> 
<xs:enumeration value=" 休 闲 类 "/> 
<xs:enumeration value=" 策 略 类 "/> 
<xs:enumeration value=" 冒 险 类 "/> 
</xs:restriction> 
</xs:simpleType> 
元 素 simpleType 定义 了 一 个 简单 类 型 的 “游戏 类 型 ”，restriction 元 素 限制 其 内 容 为 string 
类 型 。 要 列举 所 有 游戏 类 型 ， 这 里 用 到 了 enumeration 元 素 ， 其 value 属性 指定 了 枚 举 值 。 当 使 
用 枚 举 类 型 时 ， 元 素 的 值 必 须 从 组 值 中 选择 ， 且 只 能 选择 一 个 。 
对 XSD 架构 内 “类 型 ”属性 的 类 型 进行 修改 ， 应 用 上 面 创建 的 枚 举 类 型 “游戏 类 型 ”， 
代码 如 下 所 示 : 


<xs:attribute name=" 类 型 " type=" 游 戏 类 型 " use="required" /> 


当 架 构 生 成 后 ， 在 XML 文档 中 引用 该 架构 ， 并 运行 文档 进行 有 效 性 检验 ， 如 图 4-6 所 示 。 


GO etter hoinl str etor\ lee \chepterd Veene. snl 


请 收 硬 严 。 国 c:\Doewnonts and settings\kdninistrate 价 - 加 - 口 页 而 安全 和 ”工具 0 力 


<?xml version="1.0" encoding="utf-8" ?> 
- < 游戏 列表 xmins:xs="http://www.w3.0rg/2001/XMLSchema-instance” 
xs:noNamespaceSchemaLocation="game.xsd"> 
- < 游戏 类 型 =" 益 智 类 "> 
< 名 称 > 推 类 子 </ 名 称 > 
< 开发 者 > 汇 智 科技 </ 开 发 者 > 
< 版 本 >1.1.5.3RC</ 版 本 > 
游戏 : 


/游戏 > 
- < 游戏 类 型 =" 射 击 关 "> 
< 名 称 > 穿越 火线 </ 名称 > 
< 开发 者 > 昌 利 数码 </ 开 发 者 > 
< 版 本 >2.1.2RC</ 版 本 > 
< 沂 戏 > 
- < 游戏 类 型 =" 休 闲 类 "> 
< 名 称 > 超 级 大 富 售 </ 名 称 > 
< 开发 者 > 豆包 娱乐 </ 开 发 者 > 
< 版 本 >1.0.6</ 版 本 > 
游戏 > 


</ 游 戏 列表 > 


4-6 XML Schema 元 素 声 明 


4.6.2 ”基础 知识 一 一 声明 属性 


关于 如 何在 XSD 中 声明 属性 ， 其 实在 本 节 之 前 就 已 经 使 用 过 ， 这 里 我 们 来 详细 了 解 一 下 。 
XML 文件 中 的 属性 可 以 使 用 attribute 元 素来 声明 ，attribute 元 素 的 详细 语法 格式 如 下 : 


<xsd:attribute default | fixed | form | id | name | ref | type | use > 


<xsd:annotation | xsd:simpleType > 
</xsd:attribute> 


<xsd:attribute> 元 素 中 的 各 属性 及 子 元 素 如 表 4-7 和 表 4-8 所 示 。 
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表 4-7 _ attribute 元 素 的 属性 说 明 


属性 说 明 
default 指定 属性 的 默认 值 
fixed 指定 属性 的 固定 值 
form 指定 属性 的 格式 。 默 认 值 是 包含 该 属性 的 schema 元 素 的 attributeFormDefault 属性 的 值 
id 指定 元 素 的 ID。ID 值 必须 属于 类 型 ID， 并 且 在 包含 该 元 素 的 文档 中 是 唯一 的 
name 指定 属性 的 名 称 
在 该 架构 中 声明 属性 的 名 称 。ref 值 必须 是 限定 名 ， 类 型 可 以 包括 命名 空间 前 级 。 但 是 要 注意 
name 和 ref 属性 不 能 同时 出 现 
type 指定 属性 的 数据 类 型 
指示 如 何 使 用 属性 。 有 效 值 是 optional( 属 性 是 可 选 的 并 且 可 以 具有 任何 值 )、prohibited( 该 属性 
Use 用 于 其 他 复杂 类 型 的 限制 中 以 禁止 使 用 现 有 属性 ) 和 required( 该 属性 是 必需 的 ， 可 以 是 type 属 
性 允许 的 任何 值 ) 


表 4-8 ”attribute 元 素 的 子 元 素 说 明 


annotation 


定义 一 个 简单 类 型 


表 4-7 和 表 4-8 详细 介绍 了 如 何 声 明 属性 ,以 及 各 个 选项 的 作用 。 下 面 通过 一 个 XSD 架构 
文档 来 看 看 属性 的 具体 应 用 ， 代 码 如 下 所 示 : 


<?xml Version="1.0"” encoding="utf-8"?> 
<xs:schema xmlns:xs="http://www.w3.0org/2001/XMLSchema"> 
<xs:element name=" 订 和 餐 清单 "> 
<xs:complexType> 
<xs:sequence> 
<xs:element maxOccurs="unbounded"” name=" 和 餐桌 "> 
<xs:complexType mixed="true"> 
<xs:sequence minOccurs="0"> 
<xs:element maxOccurs="unbounded" name=" 菜 单 " 
type="xs:string" /> 
<xs:element name=" 可 乐 " type="xs:string" /> 
</xs:sequence> 
<xs:attribute name=" 编 号 " type="xs:unsignedByte" 
use="required" /> 
<xs:attribute name=" 状 态 " type="xs:string" use="required"/> 
<xs:attribute name=" 价 格 " type="xs:unsignedByte™ 
use="optional" default="0" /> 
</xs:complexType> 
</xs:element> 


</xs:sequence> 


ms >> 
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</zxs:complexType> 
</xs:element> 


</xs:schema> 


可 以 看 到 ， 在 这 里 使 用 attribute 元 素 定 义 了 3 个 属性 : 编号 、 状 态 和 价格 。 其 中 ， 编 号 和 
状态 属性 都 使 用 “use="required"” 语 句 定义 为 必须 具有 的 ; 价格 属性 的 “use="optional"” 定 义 
为 可 选 的 ， 并 且 “default="0"” 语 句 指定 该 属性 的 默认 值 为 0。 

现在 ， 针 对 上 面 的 XSD 架构 来 创建 一 个 符合 规范 的 XML 文件 ， 它 的 内 容 应 该 类 似 如 下 
代码 : 


<?xml version="1.0" encoding="utf-8"?> 
< 订 和 餐 清单 > 
< 餐桌 编号 ="1"” 状态 =" 空 "> 
</ 和 餐桌 > 
< 和 餐桌 编号 ="2" 状态 =" 正 在 用 餐 ” 价 格 ="98"> 
< 菜单 > 色香 肉 丝 </ 菜 单 > 
< 菜单 > 招牌 水 煮 鱼 </ 菜 单 > 
< 菜单 > 地 三 鲜 (大 份 ) </ 菜 单 > 
< 可 乐 >4 瓶 </ 可 乐 > 
</ 餐 桌 > 
</ 订 和 餐 清 单 > 


为 了 进行 验证 ， 在 XML 中 加 入 对 XSD 架构 的 引用 。 再 运行 XML 文档 ， 效 果 如 图 4-7 
所 示 。 


司 加 区 


1 三 ， 面罩- 安全 EE)- 工具 中- 网 - 


ancoding="utf-8" ?> 
"http:// www.w3.0rg/ 2001/XMLSchema-instance” 


-< 中 条 编 叶 =2 在 
< 涪 早 > 生理 有 内 丝 </ 蒜 单 > 
< 党 单 > 招牌 水 者 鱼 </ 荣 单 > 
< 党 单 > 地 三 鲜 (大 份 】</ 或 单 > 
< 可 乐 >4 得 </ 可 乐 > 


</ 乱 各 > 
<</ 订 名 涛 单 > 


4-7 XML Schema 属性 声明 


对 于 一 个 元 素 的 多 个 属性 声明 ， 可 以 使 用 attributeGroup 元 素 将 它们 定义 在 一 个 属性 组 中 ， 
然后 再 通过 ref 元 素 将 属性 组 链接 到 所 属 元 素 的 属性 声明 中 ， 这 样 做 可 以 简化 对 架构 文档 的 维 
护 及 更 新 操作 。 

例如 ， 下 面 是 给 出 的 示例 代码 : 

<xs:schema Xmlns:XS="http://www-w3-org/2001/XMLSchema"> 


<xs:element name=" 公 交 车 "> 
<xs:complexType> 


<xs:sequence> 
<xs:element maxOccurs="unbounded"” name=" 车 "> 


<xs:complexType> 


< 人 mm 


<xs:attributeGroup ref=" 规 格 "/> 
</zxs:complexType> 
</xs:element> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
<xs:attributeGroup name=" 规 格 "> 
<xs:attribute name=" 长 " type="xs:string" use="required"/> 
<xs:attribute name=" 宽 " type="xs:string" use="required"/> 
<xs:attribute name=" 高 " type="xs:string" use="required"/> 
</xs:attributeGroup> 
</xs:schema> 


引用 该 XSD 架构 的 XML 文档 如 下 所 示 : 


< 公交 车 > 
< 车 长 ="4m" 宽 ="3m" 高 ="2m” >6 路 </ 车 > 
< 车 长 ="4m" 宽 ="3m" 高 ="2.6m" > 9 路 </ 车 > 
</ 公 交 车 > 


4.7 ”编写 程序 验证 XSD 文档 


XSD 架构 不 仅 可 以 用 作 XML 文档 的 规范 ， 还 可 以 用 来 检验 XML 文档 的 合法 性 。 有 些 检 
验 程序 能 够 根据 XSD 架构 检验 XML 文档 , 并 报告 错误 。 这 样 的 程序 分 为 两 种 , 一 种 是 解析 器 ， 
另 一 种 是 编辑 器 。 在 创建 XML 和 XSD 时 通常 会 使 用 编辑 器 ， 如 VS2010， 这 时 候 它 可 以 用 来 
检验 XML 文档 。 而 在 运行 程序 时 ， 则 可 以 使 用 解析 器 对 XML 文档 进行 合法 性 检查 。 


A9 
B,! 视频 教学 : 光盘 /videos/04/ 验 证 XSD 文档 .avi 转 长 度 : 5 分 名 


4.7.1 基础 知识 


如 图 4-8 所 示 为 使 用 校 验 程序 根据 XSD 架构 对 XML 文档 进行 校 验 的 过 程 。 


肯定 XSD 位 置 


XSD 文档 


文档 是 否 合法 
4-8 校 验 过 程 


检验 程序 首先 需要 知道 使 用 哪个 大 纲 来 验证 文档 ，XML 文档 可 以 使 用 标准 的 方法 来 指定 
它 所 遵循 的 规范 。 根 据 实例 文档 中 有 没有 使 用 命名 空间 ， 可 以 选择 使 用 schemaLocation 或 者 


m=) >> 
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noNamespaceSchemaLocation 来 指定 架构 。 这 两 个 属性 都 属于 XML 规范 命名 空间 。 

如 果 验 证 的 元 素 或 者 属性 不 属于 任何 命名 空间 ， 则 使 用 noNamespaceSchemaLocation 属性 
来 指定 XSD 文档 的 物理 位 置 ， 否 则 使 用 schemaLocation 来 指定 。 

例如 ， 下 面 的 XML 文档 使 用 的 XSD 架构 位 于 “D:\XML\schemas\banks.xsd”。 


<!-- 使 用 schemaLocation 指定 XSD 架构 的 位 置 “--> 
< 附近 银行 xmlns="http://www.abclife.com/banks" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.abclife.com/banks 
D:\XML\schemas\banks.xsd"> 
< 银行 > 
< 名 称 > 中 国 工商 银行 </ 名 称 > 
< 地 址 > 人 民 路 与 文化 路 交叉 口 </ 地 址 > 
< 类 型 > 分 行 </ 类 型 > 
</ 银 行 > 
< 银行 > 
< 名 称 > 交 通 银行 </ 名 称 > 
< 地 址 > 北京 华 联 南 门 西 侧 </ 地 址 > 
< 类 型 >ATM</ 类 型 > 
</ 银 行 > 
</ 附 近 银 行 > 


需要 注意 的 是 ， 这 个 文档 的 默认 命名 空间 和 XSD 的 目标 命名 空间 相同 。 还 需要 注意 的 是 ， 
属性 schemaLocation 属于 XML 实例 命名 空间 。schemaLocation 的 值 是 一 串 用 空格 分 开 的 命名 
空间 和 XSD 架构 序列 。 例 如 ， 在 本 实例 中 可 以 理解 为 “使 用 位 于 D:\XML\schemas\banks.xsd 
的 架构 来 验证 属于 http://www.abclife.com/banks 命名 空间 中 的 元 素 ”。 

下 面 的 示例 演示 了 当 一 个 文档 中 的 元 素来 自 两 个 命名 空间 时 如 何 指定 各 自 的 架构 。 


<!-- 存在 多 个 命名 空间 时 使 用 schemaLocation --> 
< 开始 菜单 xmlns="http://www.mypc.com.cn/menus" 
xmlns:set="http://www.mypc.com.cn/settings" 
xmlns:xsi="http://www.w3.0org/2001/xXMLSchema-instance" 
xsi:schemaLocation="http://www.mypc.com.cn/menus 
D:\xXML\schemas\menus.xsd http://www.mypc.com.cn/settings 
D:\xXML\schemas\settings.xsd"> 
< 程序 >Microsoft Office Word</ 程 序 > 
< 程序 >Microsoft Visual studio</ 程 序 > 
< 实用 软件 >PDF 阅读 器 </ 实 用 软件 > 
< 实用 软件 > 万 能 视频 播放 器 </ 实 用 软件 > 
<set: 设 置 显示 大 图 标 ="false" 显示 数量 ="5"” 所 属 用 户 ="somboy"> 
</set :设置 > 
</ 开 始 菜 单 > 


这 个 例子 中 的 设置 元 素 属于 命名 空间 http://www.mypc.com.cn/settings，schemaLocation 属 
性 把 它 和 “D:\XML\schemas\menus.xsd” 架 构 关联 起 来 。 

现在 看 来 ,架构 的 位 置 实际 上 就 是 一 个 URL。 所 以 , 我 们 也 可 以 使 用 网 络 上 的 架构 ， 只 需 
通过 URL 来 引用 它 即 可 。 例 如 ， 如 下 的 代码 演示 了 这 种 方法 : 


< 信 一 
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<!-- 使 用 位 于 网 络 位 置 的 XsD 架构 --> 
< 收藏 夹 xmlns="http://www.ayhncn.com" 
xmlns:xsi="http://www.w3.0rg/2001/xXMLSchema-instance™" 
xsi:schemaLocation="http://www.ayhncn.com 
http://www.itzcn.com/favorite.xsd"> 
< 收藏 > 
< 名 称 > 窗 内 网 </ 名 称 > 
< 地 址 >www.itzcn.com</ 地 址 > 
</ 收 藏 > 
< 收藏 > 
< 名 称 > 汇 智 科技 </ 名 称 > 
< 地 址 >www .hztec.net</ 地 址 > 
</ 收 藏 > 
</ 收 藏 夹 > 


这 个 例子 中 把 命名 空间 http://www.ayhncn.com 映射 到 架构 http://www.itzen.com/favorite. 
xsd。 只 是 需要 注意 的 是 ， 虽 然 它 们 都 是 URL， 但 是 http://www.ayhncn.com 只 是 一 个 简单 的 命 
名 空间 ， 而 http://www.itzcn.com/favorite.xsd 才 是 一 个 指向 实际 内 容 (XSD 架构 ) 的 URL。 


4.7.2 实例 描述 


虽然 在 编写 XML 文档 时 通过 指定 XSD 架构 的 位 置 可 以 进行 校 验 , 但 并 不 是 所 有 情况 下 都 
需要 XML 编辑 器 。 作 为 一 名 优秀 的 开发 人 员 ， 习 惯用 程序 的 方式 来 解决 这 个 问题 。 下 面 ， 我 
们 就 通过 ASPNET 编写 一 个 Web 网 页 来 实现 XSD 架构 的 校 验 。 


4.7.3 实例 应 用 


【 例 4-4】 编写 程序 验证 XSD 文档 
(1) 首先 在 Visual Studio 2010 中 新 建 一 个 Web 应 用 程序 。 
(2) 在 默认 页 面 中 创建 一 个 表单 允许 用 户 选 择 XML 文件 和 XSD 文件 , 输入 命名 空间 。 在 
表单 中 还 有 一 个 提交 按钮 以 及 一 个 显示 结果 的 标签 。 最 终 代码 如 下 所 示 : 
<h2> 欢 迎 使 用 文档 校 验 程序 </h2> 


<p> 
选择 xML 文件 位 置 : <asp:fileupload runat="server" 
id="xmlFile"></asp:fileupload><br /> 
选择 XSD 文件 位 置 : <asp:fileupload runat="server" 
id="xsdFile"></asp:fileupload><br /> 
命名 空间 : <asp:TextBox ID="txtNameSpace" runat="server"></asp:TextBox> 如 果 
没有 ， 请 保留 为 空 。<br /> 
<asp:Button ID="Buttonl" runat="server"” Text=" 开 始 校 验 " 
onclick="Buttonl Click" /> 
<hr/> 
<span style="color:#FF0000;"> 
<asp:Literal ID="ltResult" runat="server"/> 
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</span> 
</p> 


(3) 这 样 前 台 页 面 就 制作 好 了 。 开始 编写 实现 代码 ， 先 转 到 后 台 文 件 ,添加 对 System .Xml 
和 System.Text 两 个 命名 空间 的 引用 。 


using System-Xml17 
using System.Text; 


(4) 创建 一 个 ValidateDocument0 方 法 ， 该 方法 接受 用 户 的 输入 作为 3 个 参数 。 然 后 调用 
XmlReaderSettings 类 对 XML 文件 .XSD 文件 以 及 命名 空间 进行 关联 , 并 给 出 相应 的 校 验 结 : 
完整 实现 代码 如 下 : 

StringBuilder sb = null; 

public void ValidateDocument (string docPath, string xsdPath, string ns) 


{ 


string dataFile = docPath7 
string schemaFile = xsdPath; 
string namespaceUr]l = ns; 
XmlReaderSettings settings = new XmlReaderSettings () 7 
settings.ValidationType = ValidationType.Sschema; 
settings.Schemas.Add (namespaceUr], schemaFile); 
settings.ValidationEventHandler += new System.xXml.Schema. 
ValidationEventHandler (settings ValidationEventHandler); 
string errorMessage = "这 不 是 一 个 合乎 规范 的 数据 文件 "; 
sb = new StringBuilder(); 
XmlReader reader = XmlReader.Create (dataFile, settings); 
CE 
{ 

reader.MoveToContent (); 

while (reader.Read()) 

{ 

if (reader.NodeType == XmlNodeType.Document && reader. 
NamespaceURI != namespaceUr]l) 


Response.Write (errorMessage); 
break; 


} 
catch (XmlException ex) 


1 
sb.AppendFormat ("{0}<br />", ex.Message); 


J 
finally 
| 
reader.Close(); 
if (sb.Length == 0) 
ltResult .Text=" 该 文档 是 合法 的 。"; 
else 


< 全 一 


Od 


ltResult.Text=sb.ToString (); 
Mn 


(5) 在 上 面 的 代码 中 ， 我 们 为 XmlReaderSettings 类 的 ValidationEventHandler 事件 创 寻 
一 个 委托 。 这 一 步 来 编写 事件 处 理 程序 ， 代 码 如 下 : 
void settings ValidationEventHandler (object sender, 
System.Xml .Schema-ValidationEventRrgs e) 


| 


sb.AppendFormat ("{0}<br />", e.Message); 


(6) 进入 “开始 校 验 ” 按 钮 的 单 击 事件 ， 调 用 上 面 的 ValidateDocument( 方 法 进行 校 验 。 
代码 如 下 : 


protected void Buttonl Click(object sender, EventArgs e) 


于 
if (xmlFile.HasFile && xsdFile.HasFile) // 判 断 是 否 选择 了 xsD 和 XML 文件 


上 
ValidateDocument (xmlFile.PostedFile.FileName, 
xsdFile.PostedFile.FileName,txtNameSpace.Text.Trim()); 


} 
(7) 保存 上 面 对 Web 应 用 程序 的 修改 ， 完 成 实例 的 制作 。 


4.7.4 运行 结果 


在 浏览 器 中 运行 页 面 , 首先 选择 一 个 格式 正确 的 XSD 和 XML 文件 进行 校 验 。 此 时 会 提示 
“该 文档 是 合法 的 ”， 如 图 4-9 所 示 。 如 果 在 校 验 时 出 现 了 错误 ， 则 会 给 出 详细 的 校 验 信息 ， 
如 图 4-10 所 示 。 


我 的 ASP.NET 应 用 程序 
rn 欢迎 使 用 文档 校 难 程序 
vy < El ju er [EZE 
欢迎 使 用 文档 校 验 程序 TIE 


渤 汪 XML 区 件 广 土 ， jveblenaprerdidimerxmi CR] 名 sq;8 有 ， 青 保 信 为 字 。 
选择 XSD 区 件 位 着 ， webichapter4Winner xsd [ 测 珊 .…。] ] 
命名 空间 | -上 没 有 ， 语 保留 为 衬 。 
ER 人 

本 "元 素 无 效 - 根据 数据 共 型 hitp-/jwww w3 .org/2001/KMLSchemasinteger， 值 - 
Er 和 


图 4-9 校 验 合法 时 的 显示 图 4-10 ” 校 验 不 合法 时 的 显示 
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4.7.5 实例 分 析 


pe 


整个 实例 的 重点 就 是 System.Xml 命名 空间 下 的 XmlReaderSettings 类 。 它 的 ValidationType 
属性 对 文档 执行 架构 验证 ， 并 指定 所 需 的 命名 空间 和 架构 。 

真正 的 检验 操作 是 在 调用 reader.Read() 方 法 时 开始 的 , 如 果 它 在 执行 过 程 中 遇 到 检验 错误 ， 
就 会 抛 出 System.Xml.Schema.XmlSchemaException 异常 ， 并 停止 对 XML 文档 的 检验 。 但 是 由 
于 这 里 我 们 使 用 委托 将 事件 关联 到 ValidationEventHandler 上 ， 所 以 这 个 时 候 发 现 错误 就 会 调 
用 事件 进行 记录 ， 并 继续 处 理 文档 。 这 些 信 息 将 在 最 终 检验 结束 后 显示 到 页 面 上 。 


4.8 使 用 二 进 制 数 据 


在 C# 中 可 以 使 用 字 节 数 组 来 表示 二 进 制 数 据 ， 而 在 Web 服务 的 类 型 系统 中 会 将 字 节 数组 
序列 化 为 base64Binary 类 型 。 而 且 ，base64Binary 是 Web 服务 的 内 置 数据 类 型 ， 所 以 用 户 只 
需 使 用 字 节 数 组 来 表示 和 处 理 二 进 制 数 据 ， 对 于 它 是 如 何 被 序列 化 以 及 如 何 被 传输 的 则 不 用 
操心 。 


< 视频 教学 : 光盘 /videos/04/ 使 用 二 进 制 数据 .avi 长 度 : 6 分 钟 


4.8.1 实例 描述 


Web 服务 中 可 以 使 用 二 进 制 数据 的 形式 传输 任何 文件 类 型 ， 包 括 图 像 、Office 文件 或 者 
MP3 文件 等 。 而 且 ， 在 Web 服务 中 发 送 和 接收 二 进 制 数据 也 是 非常 简单 的 。 实 现 这 个 方法 最 
简单 的 方式 就 是 以 字 节 数 组 的 形式 发 送 数据 。 

下 面 我 们 就 来 看 看 详细 的 用 法 。 


4.8.2 ”实例 应 用 


【 例 4-5】 使 用 二 进 制 数据 

(1) 在 Visual Studio 2010 中 创建 一 个 Web 服务 项 目 ， 然 后 在 asmx 文件 中 添加 对 
“System.IO” 的 引用 。 

(2) 编写 一 个 ConvertToBinary0 方 法 ， 它 可 以 读 取 文件 的 内 容 并 以 字 节 数组 形式 返 
果 。 代 码 如 下 所 示 : 


[WebMethod] 
public byte[] ConvertToBinary (string Path) 


EI 
斑 


< 
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mS >> 


FileStream stream = new FileInfo(Path) .OpenRead(); 
byte[] buffer = new byte[stream.Length]; 

stream.Read (buffer, 0, Convert.ToInt32(stream.Length)); 
return buffer; 


} 
(3) 在 


当前 解决 方案 中 添加 一 个 Web 应 用 程序 ， 并 添加 对 上 面 Web 服务 的 引用 ， 引 用 的 


名 称 为 “localhost”。 
(4) 打开 一 个 ASPX 页 面 ， 添 加 如 下 的 前 台 代 码 来 检测 使 用 二 进 制 提交 的 文本 文件 。 
<p> 


选择 一 个 文本 文件 位 置 : <asp:fileupload runat="server" 


id="Fi 


leUpload"></asp:fileupload><br /> 
<asp:Button ID="Buttonl" runat="server” Text=" 提 交 " 


onclick="Button] Click" /> <br /> 


<asp:TextBox ID="fileContent" runat="server" Height="140px" 


TextMode="MultiLine" Width="410px"></asp:TextBox> 
</p> <hr /> 


(5) 接 上 面 ， 


<p> 


出 


添加 一 个 用 于 提交 图 片 文件 的 表单 。 


选择 一 个 图 片 文件 位 置 : <asp:fileupload runat="server" 
id="FileUploadl"></asp:fileupload><br /> 


<asp:Button ID="Button2"” runat="server"” Text=" 提 交 " 


onclick="Button2 Click" /> <br /> 
<asp:Image ID="Imagel" runat="server" /> 
</p> 


(6) 现在 进入 后 台 打 开 提 交 文 本 文件 按钮 的 单 击 事件 。 编 写 代码 调用 Web 服务 中 的 
ConvertToBinary0) 方 法 ， 并 将 返回 的 二 进 制 数据 写 到 文件 中 。 最 后 显示 到 页 面 ， 实 现代 码 如 下 


所 示 : 


protected void Buttonl Click(object sender, EventArgs e) 


{ 
if 
{ 


(FileUpload.HasFile) // 判 断 是 否 选择 了 文本 文件 


localhost.Servicel s = new localhost.Servicel (); 
// 创 建 一 个 对 Web 服务 的 引用 

byte[] fileByte = s.ConvertToBinary (FileUpload.PostedFile.FileName); 
// 调 用 convertToBinary () 方 法 返回 二 进 制 

FileStream fstream = File.Create (Server.MapPath 
(FileUpload.FileName),fileByte.Length); 

// 在 服务 器 端 保存 文本 文件 

fstream.Write (fileByte, 0, fileByte.Length); 

fstream.Close(); 

StreamReader rdFile = new StreamReader 

(Server.MapPath (FileUpload.FileName),System.Text.Encoding.UTF8); 
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string Content = rdFile.ReadToEnd(); 
rdFile.Close(); 
fileContent.Text = content; // 显 示 文件 的 内 容 


} 


(7) 由 于 图 片 与 文本 文件 在 客户 端的 显示 方式 不 同 。 在 提交 图 片 按钮 的 单 击 事件 中 添加 如 
下 代码 ， 将 二 进 制 数据 转换 为 一 个 图 片 显示 到 页 面 上 。 
protected void Button2 Click(object sender, EventArgs e) 
{ 
if (FileUploadl.HasFile) // 判 断 是 否 选择 了 图 片 文件 
{ 
localhost.Servicel s = new localhost.Servicel (); 
// 创 建 一 个 对 Web 服务 的 引用 
byte[] fileByte = s.ConvertToBinary (FileUploadl.PostedFile.FileName); 
// 调 用 convertToBinary () 方 法 返回 二 进 制 
Filestream fstream = File.Create (Server.MapPath (FileUpload]l .FileName), 
fileByte.Length); // 在 服务 器 端 保存 图 片 文件 
fstream.Write (fileByte, 0, fileByte.Length); 
fstream.Close(); 
Imagel .ImageUrl = "~/"+FileUpload] .FileName; // 显 示 图 片 


} 
(8) 保存 上 面 对 Web 应 用 程序 的 修改 完成 实例 的 制作 。 
4.8.3 ”运行 结果 


首先 ， 通 过 浏览 器 来 执行 Web 服务 ， 并 调用 ConvertToBinary0 方 法 看 看 返回 的 二 进 制 数 
据 。 如 图 4-11 所 示 为 提交 文本 文件 时 的 结果 。 


_ 站 国生 区 


芥 - 加 - 口 入 ，i 面 和 安全) 工具 人 @、 巍 - 


<pxml version="1.0" encoding="utf-8" ?> 
<base64Binary 
rmins=http://tempuriorg/">MT6otL2oMbj219pA4LrNMbj2utja4KossqLW2NTYuljaA4LxEubnu7Lqvyv2jrLtiytrkstp2v 


4-11 浏览 器 调用 Web 服务 的 ConvertToBinary() 方 法 


现在 ， 运 行 创 建 的 ASPX 页 面 ， 选 择 一 个 文本 文件 并 单 击 “ 提 交 ” 按 钮 之 后 在 下 方 将 显示 
文件 的 内 容 ， 如 图 4-12 所 示 。 
接 下 来 提交 一 个 图 片 文件 试 试 ， 如 图 4-13 所 示 为 此 时 的 运行 结果 。 


< 


去 反 个 图 片 计 位 置 ，[ESGGICHLRSPEY ] 
[ 酸 ] 


ot, 让 
i 


> 
PERT 


图 4-12 提交 文本 文件 图 4-13 ”提交 图 片 文件 


4.8.4 实例 分 析 


ee 


从 运行 效果 中 可 以 看 出 ， 在 Web 服务 中 能 够 正常 处 理 二 进 制 数据 。 而且 它 是 采用 
base64Binary 作为 内 置 数据 类 型 。 

本 实例 Web 服务 中 的 ConvertToBinary() 方 法 会 对 指定 路 径 的 文件 进行 读 取 ， 然 后 返回 
byte[] 类 型 的 字 节 数组 。 客 户 端 调用 该 方法 后 ， 直 接 对 字 节 数组 进行 操作 ， 将 它 写 入 文件 中 并 
显示 到 页 面 。 

这 里 我 们 定义 了 两 种 方式 , 如 果 是 文本 文件 就 输出 内 容 ; 如 果 是 图 片 文件 就 显示 一 张 图 片 。 
当然 ， 这 里 也 可 以 是 其 他 文件 格式 ， 例 如 MP3 文件 。 


4.9.1 DTD 与 XSD 的 区 别 


DTD 与 XSD 的 区 别 。 
网 络 课堂 : http://bbs.itzen.com/thread-15246-1-1.html 


DTD 和 XSD 都 是 对 XML 文档 的 一 种 约束 ， 为 什么 不 直接 使 用 DTD， 而 又 有 XSD 呢 ? 
【解决 办 法 】 
因为 DTD 的 安全 性 太 低 了 ， 也 就 是 说 它 的 约束 定义 能 力 不 足 ， 无 法 对 XML 实例 文档 做 
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出 更 详细 的 语义 限制 。 例 如， 在 DID 中 只 有 一 个 数据 类 型 ， 那 么 使 用 PCDATA 和 CDATA 定 
义 时 ， 在 里 面 写 日 期 也 行 ， 数 字 也 行 ， 当 然 字符 串 更 是 没 问 题 。 而 XSD 正 是 针对 DTD 的 这 些 
缺点 而 设计 的 ，XSD 是 完全 使 用 XML 作为 描述 手段 ， 具有 很 强 的 语义 控制 能 力 、 扩 展 和 维护 


4.9.2 定义 simpleType 的 问题 


关于 XSD 中 定义 一 个 简单 simpleType 的 问题 。 
网 络 课堂 : http://bbs.itzcn.com/thread-15247-1-1.html 

请 教 一 个 关于 XML Schema 的 问题 : 

我 要 定义 一 个 simpleType， 其 名 称 为 nameType， 类 型 为 string， 仅 此 而 已 。 

这 么 做 的 原因 是 ， 使 人 能 非常 直观 地 知道 nameType 是 用 于 定义 各 种 name 类 型 的 ， 而 不 
能 用 于 其 他 字符 串 类 型 的 元 素 中 。 

如 果 我 写成 如 下 形式 是 不 是 合法 呢 ? 

<xs:simpleType name="nameType" base="xs:string"/> 

【解决 办 法 】 

换 成 下 面 的 试 试 。 


<xs:simpleType name="nameType"> 


<xs:restriction base="xs:string"> 
<xs:length value="10"/> 

<xs:pattern value="[a-zA-20-9] {10}"/> 
</xs:restriction> 

</xs:simpleType> 


4.9.3 用 XML Schema 规范 XML 文档 


回 王 ”用 XML Schema 规范 XML 文档 。 
Ci 团 。” 网 络 课堂 : http://bbs.itzcn.com/thread-15248-1-1.html 


本 人 根据 一 个 XML 文档 ， 写 了 一 个 XML Schema 文档 ， 本 意 是 用 此 XML Schema 文档 规 
范 XML 文档 。 可 是 在 定义 根 元 素 下 的 子 元 素 时 ,用 type="xsd:string" 来 声明 该 元 素 的 类 型 总 是 
提示 “"type" 不 能 与 "simpleType" 或 "complexType" 同 时 存在 ”。 

附 XML 文档 如 下 : 

<?xml] version="1.0" encoding="GB2312"?> 

<!-- File Name:exch03 8 xsd.xml 引用 Schema 文档 , 根 元 素 不 属于 任何 名 称 空 间 --> 

< 影片 目录 


xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:noNamespaceSchemaLocation="exch03 8.xsd"> 
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< 影片 类 别 ="” 武侠 "> 英雄 
< 主演 > 李连杰 , 梁朝伟 , 张曼玉 </ 主 演 > 
< 导演 > 张艺谋 </ 导 演 > 
< 出 品 > 新 画面 影 业 </ 出 品 > 
< 剧情 > 战国 末期 . . . . - </ 剧 情 > 
</ 影 片 > 
</ 影 片 目录 > 


XSD 文档 如 下 : 


<?xml Version="1.0"” encoding="GB2312"?> 
<!-- File name:exch03_8.xsd 文档 的 根 元 素 不 属于 任何 命名 空间 --> 
<xsd:schema xmlns:xsd="http://www.w3.o0rg/2001/XxMLSchema"> 
<xsd:element name=" 影 片 目 录 "> 
<xsd:complexTyp e> 
<xsd:sequence> 
<xsd:element name=" 影 片 " maxOccurs="unbounded" type="xsd:string"> 
<xsd:complexType> 
<xsd:sequence> 
<xsd:element name=" 主 演 " type="xsd:string"/> 
<xsd:element name=" 导 演 " type="xsd:string"/> 
<xsd:element name=" 片 长 " type="xsd:string" minOccurs="0"/> 
<xsd:element name=" 出 品 " type="xsd:string" minOccurs="0"/> 
<xsd:element name=" 剧 情 " type="xsd:string" minOccurs="0"/> 
</xsd:sequence> 
<xsd:attribute name=" 类 别 " type="xsd:string" use="optional"/> 
</xsd:complexType> 
</xsd:element> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
</xsd:schema> 


请 教 高 手 ， 该 问题 该 如 何 解 决 。 
【解决 办 法 】 
找到 XSD 文件 中 的 相同 处 ， 改 为 以 下 语句 : 


<xsd:element name=" 影 片 " maxOccurs="unbounded"> 
<xsd:complexType mixed="true"> 


这 里 的 mixed="true"， 人 允许 文本 节点 与 子 节点 同时 出 现 。 希望 上 面 的 代码 能 够 帮助 你 理解 。 


4.10 习 题 


一 、 填 空 题 
(1) XSD 可 以 分 为 Microsoft XML Schema 和 标准 。 


Eee 人 ;>> 
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(2) XSD 架构 所 用 的 命名 空间 为 
(3) XSD 内 置 数 据 类 型 float 指定 位 浮 点 数 。 
(4) 假设 ， 要 定义 一 个 表示 年 龄 的 整 型 元 素 ， 应 该 使 用 语句 
(5) 在 XSD 文档 中 要 为 元 素 赋予 默认 值 ， 使 用 的 属性 是 5 
(6) 在 XSD 文档 子 元 素 的 定义 中 ， 元 素 可 以 直接 执行 另 一 模块 ， 增 强 文档 的 
可 读 性 。 
(7) 在 定义 扩展 简单 类 型 元 素 时 ， 使 用 元 素 表 示 对 simpleContent 的 扩展 ; 
元 素 表示 对 simpleContent 的 约束 。 
(8) 要 定义 一 个 复杂 类 型 的 元 素 应 该 使 用 进行 声明 , 它 的 元 素 可 以 
进行 分 组 。 
二 、 选 择 题 
(1) 下 列 不 属于 XSD 的 特点 的 是 
A， 能够 定义 哪个 元 素 是 子 元 素 
B. 数据 类 型 多 样 性 
C. 简单 性 


(2) 


D. 拥有 不 同 于 XML 的 独立 语法 

在 XSD 文档 中 必须 引用 的 命名 空间 是 

A. http:/www.w3.org/2001/XMLSchema-instance 
B. http://www.w3.org/2001/XMLSchema-instanc 
C. http://www.w3.org/2010/XMLSchema-instance 
D. http:/www.w3.org/2001/XMLSchema 


(3) 在 XSD 中 用 表示 一 个 字符 串 类 型 。 
A. string B. char C. varchar D. text 
(4) XSD 文档 中 元 素 element 的 属性 指定 子 元 素 可 以 出 现 的 最 多 次 数 。 
A. maxOccurs B. minOccurs 
C. max D. min 
(5) 如 果 在 W3C XML Schema 文档 中 定义 了 目标 命名 空间 ， 应 该 在 XML 文档 中 使 用 
引用 该 Schema 文档 。 
A. Location 
B. noNamespaceSchemaLocation 
C. schemaLocation 
D. namespaceLocation 
(6) XSD 文档 中 元 素 定义 了 子 元 素 如 果 在 实例 文档 中 出 现 ， 都 必须 按照 指定 
的 顺序 显示 。 
A. sequence B. all C. group D. choice 
(7) W3C XML Schema 文档 中 ，attribute 元 素 的 属性 use 值 为 表示 属性 是 可 选 
的 并 且 可 以 具有 任何 值 。 
A. optional B. prohibited C. required D. fixed 


< 人 mm 
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三 、 上 机 练习 

上 机 练习 1: 编写 显示 个 人 档案 的 XML 和 XSD。 

我 们 已 经 学 习 了 关于 XSD 的 相关 知识 。 本 次 上 机 练习 要 求 根据 所 学 知识 ,编写 一 个 XML 
文档 记录 个 人 档案 信息 .并 针对 该 XML 编写 规范 的 XSD 架构 ,然后 在 XML 文档 引用 该 XSD。 
XML 文档 的 实现 效果 如 图 4-14 所 示 。 

F:\ 代 码 \ 第 四 章 上 机 . xml - Windows Internet Explorer 


下 了 \ 代 码 \ 第 四 章 上 机 .xml 
痪 收 蕊 天 。 须 了 代码 \ 第 四 章 上 机 ml 


<?xml version="1.0" encoding="utf-8" ?> 
- < 个 人 档案 xmins;xs="http://www.w3.org/2001/XMLSchema-instance" 
xs:noNamespaceSchemaLocation=" 第 四 章 上 机 .xsd"> 
< 姓名 > 王 宝 宝 </ 姓 名 > 
< 年 龄 >21</ 年 龄 > 
< 出 生年 月 日 >1990-01-01</ 出 生年 月 日 > 


< 毕业 院 校 > 郑州 大 学 </ 毕业 院 校 > 
< 将 长 > 画 画 </ 特 长 > 
< 专业 > 美术 系 </ 专 业 > 


</ 其 他 信息 > 
</ 个 人 档案 > 


图 4-14 ”运行 效果 
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内 容 摘要 : 

WSDL 是 一 个 基于 XML 的 语言 ， 用 来 描述 Web 服务 的 接口 方法 、 调 用 方法 所 使 用 的 协 
议 ， 方法 的 参数 以 及 参数 的 数据 类 型 等 内 容 。 总 之 ，WSDL 中 包含 了 访问 Web 服务 需要 的 所 
有 数据 。 

虽然 ASPNET 的 Web 服务 可 以 自动 生成 WSDL 文档， 而 且 在 使 用 Web 服务 时 也 不 用 了 
解 太 多 的 WSDL 知识 。 但 是 ， 了 解 WSDL 可 以 加 深 对 Web 服务 的 理解 ， 并 可 以 对 自动 生成 的 
WSDL 文档 进行 调整 ， 以 及 解决 一 些 与 WSDL 相关 的 问题 。 

本 章 将 会 对 WSDL 进行 详细 的 讲解 ， 包 含 如 何 查看 WSDL 文档 、WSDL 文档 的 结构 ， 以 
及 WSDL 的 各 个 组 成 部 分 等 。 

学 习 目 标 : 

@ 了 和 解 什么 是 WSDL 
了 和 解 WSDL 文档 的 组 成 部 分 
掌握 如 何 查 看 Web 服务 的 WSDL 文档 
熟悉 WSDL 文档 的 各 个 元 素 
掌握 WSDL 文档 的 使 用 方法 


5.1 什么 是 WSDL 


WSDL(Web Services Description Language, Web 权 义 侧 逻 臻 说 ) 攻 世 了 圈 棺 价 罗 Web 杷 义 
哨 由 映 姑 保 玛 Web 权 义 下 丛 医 XML 残 谈 ， 三 曼 抓 搬 合 人 德 缮 葵 搁 告 丰 映 伪 。 
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,视频 教学 : 光盘 /videos/05/ 什 么 是 WSDL.avi 全 长 度 : 6 分 钟 


第 4 笼 扭伤 寂 和 伯 XSD， 察 伍 三 Web 权 义 条 粮 坝 风 人 扬 ， 缂 想 从 Web 权 义 蒜 是 军 续 柠 从 好 
苞 焕 医 旋 擅 粮 坦 。 伪 攀 舟 稿 异 书 娄 ，XSD 捣 实 父 Web 杷 义 蔬 禁 鉴 顺 策 叭 档 剑 哨 来 斤 。 

柬 到， 知 昵 达 梓 也 称 愧 微 ， 俱 谚 ， 扭 优 判 象 匆 也 了 Web 权 义 ， 厂 买 制 实 从 忆 细 齐 条 XSD 
缂 框 束 侠 。 避 交 订 家 姑 促 吡 曼 抓 伦 缩 Web 杷 义 来 商 价 匀 腺 ， 丛 否 氨 了 上 昕 洱 瑶 圈 晒 条 吞 旋 哮 ? 

叶 被 务 上 昕 洱 妃 般 来 过 梓 却 了 。 

@ 钙 件 署 LI 卫 娩 逛 展 Web 权 义 苍 侈 上 眠 棒 。 

@ 和 遗 速 佼 扬 告 众 上 听 彤 号 谥 胡 艇 例 因 Web 权 义 薰 晓 抓 。 

丛书 革 典 形 条 上 昕 洱 盘 怕 醉 来 蕊 了 赣 钠 条 隐 馈 : 拒 薄 咏 依 哆 芍 寺 障 风 上 明 争 惯 艇 侈 圈 析 了 Web 
权 义 晒 ， 促 佑 条 帧 麻 ( 姑 Visual Studio) 昼 洱 缆 促 佑 搬 便 伦 促 床 包 。 时 三 过 价 帧 主要 柴 是 此 父 试 
迷 了 Web 权 义 ， 署 LI 条 俱 硝 人 必 爱 饶 振 。 

就 介 昕 洱 : 圈 稿 应 腺 陡 压 条 上 昕 彤 搬 仇 世 了 殿 屁 条 驹 四 证 桂 。WSDL 赋 履 可 梓 世 了 却 仪 XML 
歌 摧 条 上 媚 棒 ， 察 鸡 遇 从 Web 权 义 呆 了 昕 鞭 医 蚜 丝 ， 卡 挫 : Web 权 义 撤 茎 藉 侩 凋 、 斋 挠 务 佼 示 
原 谊 、 卡 嘱 务 搁 告 、 搁 告 争 务 上 昕 洱 丛 否 昕 洱 粤 吞 话 粮 坟 镀 。 

时 三 履 霹 仪 XML 医 , 拔 俗 WSDL 显 萎 稿 应 叶 陡 诬 医 ,只 蜂 估 叶 陡 砍 医 。 肯 助 卫 价 杜 昌 苗 
薄 咏 帧 麻 显 逐 要 据 Web 杷 义 圈 扬 WSDL 上 昕 棒 ， 只 逐 导 阑 WSDL 既 桂 ， 时 扬 瑶 圈 瞪 厅 Web 栖 
义务 俱 硝 。 传 姑 Visual Studio 2010， 扭 伤 屋 芍 集 笼 哆 凑 治 诅 谋 侯 连 稿 。 

市 卓 助 三 圾 ，WSDL 区 杜 昌 和 驾 柴 履 1.2， 察 得 IBM 哨 避 廷 将 电 阑 周 钙 实 ， 圈 仪 耸 Web 
权 义 医 政 洱 词 荟 。 

; 遗 应 WSDL 仿 三 味 齐 原 狂 剖 瑰 晒 ,应 应 虚 仪 侈 和 哆 Web 权 义 茶 歌 洱 启 蔡 , 传 姑 杜 昌 蒜 WSDL 
) 1.2 齐 蔡 。 佰 姑 杯 周 晒 搬 出 槐 了 Web 权 义 ， 避 察 赋 祝 禄 家 Web 权 义 条 站 暴 肯 标 ， 均 豁 Web 权 
久 攻 WSDL 婚 桂 。 华 笼 猎 展 Web 杷 义 芳 WSDL 媚 禁 遏 祛 谎 让 。 

也 了 WSDL 媚 桂 履 展 世 了 Web 权 义 侩 鹿 、 碑 谊 哨 搁 告 茸 锣 绕 由 映 。 察 得 Web 权 义 条 莱 咏 
险 搬 仿 ， 偿 包 仪 Visual Studio 2010 更 咏 愤 尊 叶 俗 垄 幕 咏 晒 朴 扬 Web 权 义 俱 硝 稻 句 转 扬 WSDL 
既 述 。 

传 寻 ， 垄 籍 2 笼 松 伦 缩 连 寻 杯 垄 演 充 哈 争 导 羔 庆 来 “?wsdl” 攻 Web 杷 义 URL 占 沛 晒 , 杷 
义 吹 赋 佑 进 场 Web 杷 义 条 WSDL 记 棒 。 联 过 酬 鉴 覃 Web 权 义 条 进 祛 开 厄 稻 句 圈 扬 徐 。 和 后 侈 ， 
扭 优 寨 姜 叶 俗 稻 幅 署 LI WSDL 记 棒 ， 时 三 察 呆 履 旱 踪 条 XML 旗 侠 。 

艺 兰 楷 瞄 也 了 麻 侯 条 WSDL 目标 ， 伪 联 妃 仍 父 试 WSDL 弃 述 匣 缁 柠 。 俱 谚 ， 关 象 茵 Web 
权 义 姑 艺 : 


namespace WebServicel 
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[WebService (Namespace = "http://tempuri.org/")] 


[WebServiceBinding (ConformsTo = WsiProfiles-BasicProfilel 1)] 
[System.ComponentModel .ToolboxItem(false)] 
public class Servicel : System.Web.Services.WebService 


{ 


} 


[WebMethod] 
public string HelloWorld() 
{ 


return "Hello World"; 


姥 范 拔 禄 直 三 演说 吹 赣 场 医 WSDL 既 桂 : 


<?xml 


<wsdl: 
xmlns: 
xmlns: 


xmlns 
xmlns 
xmlns 
xmlns 
targe 
xmlns 


Version="1.0"” encoding="utf-8"?> 

definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
tm="http://microsoft.com/wsdl/mime/textMatching/" 
soapenc="http://schemas.xmlsoap.org/soap/encoding/" 
:mime="http://schemas.xmlsoap.org/wsdl/mime/" 
"http://www.w3.0rg/2001/XMLSchema" 
:soapl2="http://schemas.xmlsoap.org/wsdl/soap12/" 
:http="http://schemas.xmlsoap.org/wsdl/http/" 
tNamespace="http://tempuri.org/" 
:wsdl="http://schemas.xmlsoap.org/wsdl/"> 


:tns="http://tempuri.org/" xmlns: 


<wsdl:types> 
<s:schema elementFormDefault="qualified" 


<targetNamespace="http://tempuri.org/"> 
<s:element name="HelloWorld"> 
<s:complexType /> 
</s:element> 
<s:element name="HelloWorldResponse"> 
<s:complexType> 
<s:sequence> 
<s:element minOccurs="0" maxOccurs= 


" name="HelloWorldResult" 
type="s:string" /> 
</s:sequence> 
</s:complexType> 
</s:element> 


</s:schema> 


</wsdl:types> 
<wsdl:message name="HelloWorldSoapIn"> 


<wsdl:part name="parameters" element="tns:HelloWorld" /> 
</wsdl:message> 
<wsdl:message name="HelloWorldSoapOut"> 


<wsdl:part name= 


parameters" element="tns:HelloWorldResponse" /> 


</wsdl:message> 


<wsdl:portType name="ServicelSoap"> 


<wsdl:operation name="HelloWorld"> 


< 


<wsdl:input message="tns:HelloWorldSoapIn" /> 
<wsdl:output message="tns:HelloWorldSoapout" /> 
</wsdl:operation> 
</wsdl:portType> 
<wsdl:binding name="ServicelSoap" type="tns:ServicelSoap"> 
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" /> 
<wsdl:operation name="HelloWorld"> 
<soap:operation soapAction="http://tempuri.org/HelloWorld" 
style="document" /> 
<wsdl:input> 
<soap:body use="literal" /> 
</wsdl:input> 
<wsdl:output> 
<soap:body use="literal" /> 
</wsdl:output> 
</wsdl:operation> 
</wsdl:binding> 
<wsdl:service name="Servicel"> 
<wsdl:port name="ServicelSoap" binding="tns:ServicelSoap"> 
<soap:address location="http://localhost:5737/Servicel.asmx" /> 
</wsdl:port> 
</wsdl:service> 
</wsdl:definitions> 


嬉 书 芝 俱 硝 技 禄 ,号 俗 性 了 区 景 幸 列 逢 训 迷 警世 了 上 蜡 踪 医 XML 讼 禁 ，1 内 于 谢 虹 WSDL 既 
检 寨 凌 钙 圈 XML 致 注 。 毁 狮 ， 达 1 履 世 了 缁 柠 笨 原 联 浊 婴 芳 XML 眠 桂 ， 察 务 要 守 绪 三 
definitions， 应 艺 卡 履 人 5 了 成 外乡 ， 列 剧 鉴 types、message、portType、binding 哨 service， 迷 
针 贞 担 第 展 迷 价 官 结 贷 幕 褒 衣 ， 早 三 垄 涯 区 屠 舍 委 绕 谨 让 。 


5.2 剖析 WSDL 文档 结构 
书 世 苞 条 杜 哆 缆 剖 从 也 了 Web 权 义 徐 WSDL 蔬 桂 ， 侯 苦 剖 丽 父 必 奶 昌 共 哈 味 竖 限 、 电 笼 


哨 崔 帆 。 芍 过世 区 履 伦 缩 WSDL 底 桂 务 绪 柠 丛 否 察 伤 拔 祈 襟 条 呢 雍 。 
cy 视频 教学 : 光盘 /videos/05/WSDL 文档 结构 .avi 人 @@ 长 度 :18 分钟 


5.2.1 ”基础 知识 一 一 WSDL 文档 结构 


碍 XSD 世 梓 ，WSDL 1 改 世 了 XML 档 剑 。 联 买 WSDL 医 世 了 长 应 德 缮 哨 斋 枞 务 档 剑 ， 
察 短 缮 驳 遇 父 Web 权 义 条 上 昕 洱 哨 捍 伍 。 

也 了 WSDL 媚 桥 怡 赂 丛 definitions 仿 三 要 电 络 ， 泣 争 叶 俗 卡 嘱 types、message、portType、 
binding 哨 service 至 纱 。 姑 艺 撤 襟 三 WSDL 刀 禁 条 考 米 柠 : 


<definitions> 
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<types> 

types 卸 妈 医 德 绕 实 交 
</types> 
<message> 

message 秆 缘 医 逢 绕 实 交 
</message> 
<portType> 

portType 是 弧 医 竹 绕 实效 
</portType> 
<binding> 

binding 是 颖 医 逢 绕 宝 交 
</binding> 
<service> 

service 包 颖 慕 逢 绕 宝 交 
</service> 

</definitions> 


过 5 了 官 妈 医 签 艇 由 映 姥 范 。 

@ types: 过 都 列 宝 玄 人 Web 权 鲸 倍 晓 苗 拔 来 许 扩 粮 直 震 叭 ， 哮 复 电 颖 医 呆 淤 忱 缠 癸 拔 
影 畴 。 踪 应 侈 晓 XML Schema 但 三 粮 址 网 俩 棺 淮 逻 。 

@ 。 message: 过 都 到 裤 雍 伯 淤 忱 哨 淤 忱 佼 进 条 举 贻 粮 圳 邵 宝 玄 。 志 人 握 履 侈 圈 types 裤 雍 元 
粮 坊 检 实 玄 旋 了 淤 居 蒜 放 扬 柠 。 

@ portType: 可 都 列 鉴 世 了 举 贻 提 伍 务 痢 祝 ， 实 雍 伯 技 来 报 伍 哨 进 场 务 避 友 淤 忱 。 

@ binding: 过 部 列 三 氨 了 谏 修 条 筋 告 粮 坊 酬 裤 雍 人 淤 忱 检 彤 哨 原 谊 。 

@ service: 过 都 列 实 雍 人 Web 权 义 茶 URL 坎 侩 居 。 

丛书 5 了 坚 绑 柠 扬 从 Web 权 义 攻 寨 旋 宝 北 , 夏 买 察 优 匣 减 细 蒜 应 缘 无 。 湾 争 ,types、message 
哨 portType 至 乡 盖 周 缠 扬 从 WSDL 蒸 举 上 贻 痢 列 ， 稣 三 权 义 搁 告 宝 交 (Service Interface 
Definition)。 达 价 昌 如 侈 遇 从 Web 权 义 攻 霸 炉 恤 刑 ， 察 优 猎 第 仪 矿 时 哨 尊 侯 藻 稿 应 至 访 ，1 泽 
来 搬 合 伦 保 减 仪 擒 聆 芍 保 黄 格 扒 Web 权 义 寺 传 菇 偷 忱 。 

binding 哨 service 宇 绪 缠 扬 从 Web 权 义 实 雍 柬 谋 侯 都 列 ， 稣 三 权 义 村 政 宝 亥 (Service 
Implementation Definition)。 察 伤 的 宝 伯 详 隐 猫 实 Web 权 义 寺 会 撤 胡 条 偷 忱 ， 传 姑 ， 佼 进 原 谊 、 
Web 权 义 茶 贡 霹 镀 。 

WSDL 婚检 条 权 义 搁 告 宝 亥 哨 权 义 寺 璨 宝 雍 龟 都 到 和 踪 速 binding 坚 结 销 搁 星 棺 ， 姑 坚 5-1 
拔 襟 三 志 价 时 缅 限 条 减 细 。 

三 仪 材 姓 吉 丰 帅 WSDL 旗 要 争 味 蛙 缅 产 限 条 减 细 , 垄 坚 5-1 争 侈 圈 伯 3 称 速 搁 策 哎 。 当 争 
原 吡 缮 纹 敌 众 视 襟 “ 影 畴 ” 哨 “ 和 影 畴 ”条 减 细 ， 吨 吡 缮 绑 篮 众 视 襟 “ 俑 需 ” 减 网 ， 原 吡 艇 修 
徐 妈 衔 禄 “ 卡 嘱 ” 减 细 。 

芍 坚 $-1 争 , message 宇 绪 侈 圈 types 官 络 茹 实效 , portType 官 先 伐 晓 message 坚 盎 务实 玄 ， 
binding 虹 绑 影 圈 portType 宦 穆 ，service 审结 只 影 晓 binding 坚 纱 。 香 毁 叶 讶 ， 带 5 了 宦 颖 
属 签 原 影 固 减 细 。 昌 者 ，portType 哨 binding 电 络 而 卡 嘱 operation 电线 ， 联 买 binding 官 络 
和 争 霹 operation 寞 和 绪 恬 展 portType 宦 绪 艺 operation 虹 绑 条 遇 世 毁 侧 逻 .service 宇和 绪 只 卡 呢 port 
守 乡 。 
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© -和 


权 义 搁 告 实效 
types | 
NE 
message 
portType | o 


一 到 


要义 寺 瑰 实 记 


图 5-1 WSDL 文档 结构 


玖 也 了 WSDL 既 述 争 叶 俗 泽 来 types 时 纤 ， 倩 蜂 姑 杯 来 采 脉 剖 瑰 也 刺 。 亦 侃 4 了 入 络 呈 俗 
剖 瑰 奶 丈 ，1 哮 俗 泽 来 。 垄 WSDL 记 禁 争 味 了 时 乡 务 剖 政 球 应 医 来 剂 实 务 ， 列 剧 中 types、 
message、portType、binding 哨 service。 


6 $》 在 WSDL 文档 中 还 有 两 个 不 常用 的 元 素 , documentation 元 素 用 于 提供 一 个 可 阅读 


提示 的 文档 ， 它 可 以 包含 在 任何 其 他 元 素 中 ; import 元 素 用 于 导入 其 他 WSDL 文档 或 
者 XSD， 从 而 实现 WSDL 文档 的 模块 化 。 


5.2.2 ”实例 描述 
展 仪 茵 咏 依 哆 枕 由 , 扭 优 静 艇 研 邯 WSDL 婚 禁 览 姑 促 碍 Web 权 义 瞪 减 肽 务 。 材 名 艇 务 恪 ， 
放 蔬 友 邯 寻 保 陡 座 厂 玉 就 WSDL 旗 禁 。 


书 世 区 伦 缩 从 WSDL 记 禁 务 考 华 缮 柠 。 过 伺 扭 伤 属 剧 条 也 了 WSDL 婚 桂 ， 中 过 展 察 务 列 
束 ， 满 羔 璇 就 WSDL 味 了 宦 绪 蒜 伍 圈 。 


5.2.3 ”实例 应 用 


【 传 5-1】 动 束 WSDL 既 述 弹 柠 
(1) 垄 IIS 书 昌 象 也 了 味 三 “Service” 匣 蜡 挺 肯 德 ， 履 六 晓 屠 淹 米吉 骸 名 只 书 医 也 了 既 快 
如 。 传 寻 ， 垄 业 寺 传 争 赂 “E:\myRoot\Service”。 
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(2) 区 Service 由 挺 晴 德 艺 亨 条 世 了 Web 权 义 诈 侠 ， 哈 咏 夺 “HelloService.asmx” 
(3) 圈 庶 大 柴 担 萍 HelloService.asmx 启 侠 遏 祛 署 迭 ， 消 勿 姑 艺 俱 硝 克 虎 世 了 Web 权 义 ， 


证 影 辣 撤 静 务 哈 咏 竖 限 。 


<$%Q@ WebService Language="C#" Class="HelloService" $%> 
using System; 

using System.Web; 

using System.Web.Services; 


(4) 搁 艺 棺 剧 条 Web 权 义 粮 ， 俱 硝 姑 艺 撤 襟 : 


[WebService (Namespace = "http://tempuri.org/")] 
[WebServiceBinding (ConformsTo = WsiProfiles.BasicProfilel 1)] 
public class HelloService : System.Web.Services.WebService 

{ 

} 


(5) 刺 区 三 HelloService 粮 剖 象 也 了 Web 权 义 听 洱 ， 察 搁 器 世 了 害 策 于 吞 话 ， 厂 进 场 蕊 了 


庆生 助 晒 限 荔 殉 道 害 策 于 。 寺 柬 俱 硝 娃 艺 : 
[WebMethod] 


public string sayHello(string name) 


{ 


return " 功 道 " + name + " 慕 谊 隐 ， 和 指 助 晒 限 三 : ”+ System.DateTime.Now; 


} 
(6) 崩 毁 ，Web 权 义 条 俱 硝 赋 署 LI 寨 从 ， 众 宴 展 察 务 俑 测 。 


5.2.4 ”运行 结果 


担 莫 党 说 只 ， 移 哆 迈 市 http:/WlocalhostService/HelloService.asmx。 几 原 划 “ 权 义 由 上 映 ” 铺 


搁 棺 柏 虞 儿 展 豁 Web 权 义 条 WSDL 婚 棒 ， 担 东 哆 落网 其 姑 坚 5-2 拔 禄 。 


~ [BI [x 
遍 必 靖 关 | 古 it://loealiost/Sarvi sledlsSer er am 3 司 ， 可 而 tj ”Rs 全 名” 工 D- 司 、 


pml version="1.0" enc 
~ ewsdlcefinitione mine: 
xmlns;tm="http:/ /mi 


"http:/ /tempuri.org/” 
=httpc//schemas xmlsoap org/ wsdl/ soap12/" 
amespace—"http:/ /tempuri.org/” 


5-2 ”查看 Web 服务 的 WSDL 文档 
学车 谷 坚 5-2 拔 和 神医 WSDL 媳 禁 三 舍 ， 列 束 世 艺 味 莉 列 条 缠 扬 。 


届 冤 WSDL 媚 禁 茶 和 1 被 敬 XML 员 览 , 察 档 谢 和 后 助 共 禁 蜂 蕊 了 XML 上 旗 棍 , 静 艇 侈 因 XML 


<?xml Version="1.0"” encoding="utf-8" ?> 


第 2 被 览 WSDL 证 棒 条 要 守 纱 definitions， 谈 争 卡 嘱 人 展 奶 了 哈 味 竖 限 茶 贞 映 。 

搁 睦 履 香 types 时 乡 柠 扬 笨 types 都 列 。types 是 络 争 和 卡 旷 哈 味 竖 限 条 贞 N 了 罗 ， 毁 者 连 来 到 
络 粮 坦 医 实 交 。 垄 达 镀 实效 仪 鱼 了 官 结 ， 直 sayHello 哨 sayHelloResponse。 察 伤 丁 蜂 例 曼 XSD 
梯 实 效 匣 依 枞 粮 塌 ， 尝 争 呆 卡 呢 也 了 害 策 于 剖 坝 是 穆 ， 便 玫 哈 味 三 name 哨 sayHelloResult。 

达 都 列 俱 硝 姥 艺 拔 禄 : 


<wsdl:types> 
<s:schema elementFormDefault="qualified"™" 
targetNamespace="http://tempuri.org/"> 
<s:element name="sayHello"> 
<s:complexType> 
<s:sequence> 
<s:element minOccurs="0" maxOccurs="1" name="name" 
type="s:string" /> 
</s:sequence> 
</s:complexType> 
</s:element> 
<s:element name="sayHelloResponse"> 
<s:complexType> 
<s:sequence> 
<s:element minOccurs="0" maxOccurs="1" 
name="sayHelloResult" type="s:string" /> 
</s:sequence> 
</s:complexType> 
</s:element> 
</s:schema> 
</wsdl:types> 


搁 沙 梯 剖 瑰 医 钨 了 message 坚 几 蜂 WSDL 条 message 吏 到 。 姑 杯 扭 伤 拦 报 伍 瞄 估 蜂 昕 洱 ， 
脚 交 message 坚 乡 赋 展 订 仪 听 洱 条 吞 旋 。 氨 了 message 至 乡 叭 悍 世 了 扮 聆 奶 了 part 成 到 几 缠 扬 ， 
氨 了 part 成 守 乡 瞪 拒 仪 听 洱 吞 旋 害 入 争 粤 世 了 吞 旋 。 氨 了 昕 洱 酬 麻 来 进 阑 哨 示 剖 ， 察 伤 到 剧 踪 
回味 稻 苍 message 官 络 祁 禄 。 

上 昕 洱 务 进 阑 三 sayHelloIn， 察 来 也 了 part 宇 纱 ， 味 稣 三 parameters， 剖 直 告 sayHello 虹 物 
厦 实 ; 昕 洱 务 示 放 三 sayHelloSoapOut， 察 人 来世 了 part 宇 纱 ， 粮 吉 香 sayHelloResponse 和 大宝。 

速 邦 列 俱 硝 姑 艺 拔 襟 : 

<wsdl:message name="sayHelloSoapIn"> 

<wsdl:part name="parameters" element="tns:sayHello" /> 
</wsdl:message> 

<wsdl:message name="sayHelloSoapOut"> 


<wsdl:part name="parameters" element="tns:sayHelloResponse" /> 
</wsdl:message> 
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几 应 艺 改 portType 痢 列 ， 察 得 portType 官 络 实 交 ， 叶 俗 剖 碧 奶 殊 。 获 portType 宇和 绑 争 叶 
俗 卡 嘱 也 了 扮 险 奶 了 operation 成 是 络 。 芍 达 妓 卡 上 也 了 portType 是 纤 ， 味 稣 三 
“HelloServiceSoap”， 湾 争 卡 呢 葵 operation 废 审 络 味 三 “sayHello”， 迷 了 味 稣 哨 Web 杞 义 
争 医 Web 昕 洱 味 稣 瞪 周 。 
芍 operation 官 颖 沧 , input 哨 output 废 审 物 薰 message 宪 眉 影 晓 message 前 列 争 医 message 
时 和 缅 。 伪 联 ， 族 了 portType 部 列 赋 有 瞪 和 后 仪 敬 四 从 上 昕 洱 “string sayHello(string name)”。 
可 都 列 俱 硝 姑 艺 撤 襟 : 
<wsdl:portType name="HelloServiceSoap"> 
<wsdl:operation name="sayHello"> 
<wsdl:input message="tns:sayHelloSoapIn" /> 
<wsdl:output message="tns:sayHelloSoapOut" /> 
</wsdl:operation> 
</wsdl:portType> 


”由 于 portType 定义 可 以 放 在 单独 的 文件 中 ， 所 以 在 WSDL 文档 中 可 以 没有 
组 示 | portType 元 素 。 


书 粹 伦 缩 务 types、message 哨 portType 部 列 柠 扬 从 WSDL 是 桂 条 杷 义 搁 告 裤 雍 都 烈 。 察 
俐 寺 隘 书 赛 旋 吉 侈 归 父 Web 权 义 争 黄 捍 位 ， 卡 嘱 示 阑 哨 撑 前 吞 旋 俗 否 味 了 吞 旋 荔 粮 址 。 瑰 芍 
棺 上 旺 上 曙 WSDL 昕 覃 粤 权 义 寺 下 宝 雍 都 列 姑 促 拦 报 伍 、 佼 进 原 诊 、 署 硝 齐 创 俗 否 Web 杷 义务 侩 
闻 拓 细 昨 检 。 

范 鞭 峰 binding 痢 列 ， 露 都 列 哮 俗 泽 来 、 来 也 了 扮 险 奶 了 binding 宦 绢 。 芍 迷 了 传 成 争 卡 嘱 
也 了 binding 昌 纱 ， 味 稣 夺 HelloServiceSoap。 练 实 葡 portType 三 HelloServiceSoap， 湾 争 卡 嘱 
邯 侩 忱 来 狐 圈 揽 伍 男 佼 进 原 谊 、SOAP 淤 忱 杭 遇 哨 署 硝 杭 彤 。 达 痢 列 俱 硝 寻 水 拔 禄 : 


<wsdl:binding name="HelloServiceSoap" type="tns:HelloServiceSoap"> 
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" /> 
<wsdl:operation name="sayHello"> 
<soap:operation soapAction="http://tempuri.org/sayHello" style= 
"document" /> 
<wsdl:input> 
<soap:body use="literal" /> 
</wsdl:input> 
<wsdl:output> 
<soap:body use="literal" /> 
</wsdl:output> 
</wsdl:operation> 
</wsdl:binding> 


杜 响 世 邦 列 览 service， 垄 达 七 都 列 拦 助 其 医 练 实 碟 寺 隘 葡 Web 权 久 侩 记 有 捧 网 趾 棺 。 遗 连 
address 昌 和 财务 location 宪 眉 的 袜 Web 权 义 条 寨 族 URL。 

速 邦 列 俱 硝 姑 艺 撤 襟 : 

<wsdl:service name="HelloService"> 


<wsdl:port name="HelloServiceSoap" binding="tns:HelloSserviceSsoap"> 
<soap:address location="http://localhost/Service/HelloService.asmx"/> 


< 人 mm 


</wsdl:port> 


</wsdl:service> 


5.2.5 ”实例 分 析 


Ce 


由 于 完整 的 WSDL 文档 比较 庞大 ， 而 且 难于 阅读 。 为 了 简洁 起 见 ， 这 里 删除 了 引用 HTTP 
POST 和 HITP GET 的 元 素 部 分 ， 以 方便 阅读 。 

至 此 , 我 们 对 Web 服务 的 WSDL 文档 已 经 有 了 整体 了 解 。 通 过 这 个 WSDL 文档 可 以 得 到 
的 信息 有 : 


Web 服务 位 于 http://localhost/Service/HelloService.asmx。 

可 以 使 用 HITP SOAP 调用 它 ， 并 定义 了 SOAP 的 格式 。 

方法 的 名 称 为 sayHello， 它 的 输入 为 sayHelloIn， 输 出 为 sayHelloOut。 

SOAP 请 求 消息 的 输入 参数 由 sayHello 元 素来 指定 。 

SOAP 响应 消息 的 输出 参数 由 sayHelloResponse 元 素来 指定 。 

输入 参数 的 名 称 为 name， 类 型 为 string; 输出 参数 的 名 称 为 sayHelloResult， 类 型 也 
是 string。 


5.3 WSDL 文档 元 素 


垄 娄 区 助 革 , 伦 缩 父 伯 交 攻 WSDL、WSDL 既 覆 缠 扬 都 列 哨 寻 保 术 上 蜡 Web 权 义 条 WSDL 
媚 棒 ， 联 买 遗 连 寺 使 父 试 伯 氨 了 潮 列 务 寺 障 嘱 玄 。 垄 志 世 苞 ， 扭 伤 层 找 燃 宇 几 化 WSDL 猎 述 
争 剖 政 条 冤 哆 纲 订 短 缮 耸 缩 谱 寨 旋 残 洱 。 


= 视频 教学 : 光盘 /videos/05/WSDL 文档 元 素 .avi @ 长 度 : 27 分钟 
5.3.1 ”基础 知识 一 一 definitions 根 元 素 


区 WSDL 既 涟 争 , definitions 电 络 览 要 惠 线 ,1 赋 蜂 站 抢 守 缅 来 买 采 逐 来 世 刺 。 攻 definitions 
时 颖 争 宝 亥 从 WSDL 媚 禁 争 圈 出 条 喻 味 竖 限 ， 信 XSD 哈 味 竖 限 哨 SOAP 哈 味 竖 限 镑 。 
姥 沙 拔 神 三 也 了 痊 翰 攻 definitions 要 是 络 蔚 凡 角 。 


<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 


xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/" 
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" 
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" 
xmlns:tns="http://tempuri.org/™" 
xmlns:s="http://www.w3.0rg/2001/XMLSchema™" 
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" 
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xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 


targetNamespace="http://tempuri.org/"> 

哈 味 坚 限 展 仪 寻 保 谋 列 WSDL 径 述 是 颖 黄 应 钙 钥 ， 察 区 连 URL 唆 世 圳 档 谢 人 时 纱 ， 腥 轧 
守 绑 徐 哈 味 钾 站 。 传 姑 ，“xmlns:s” 赋 俱 祝 哈 咏 竖 限 http://www.w3.org/2001/XMLSchema， 乱 
艇 侈 圈 达 了 哈 味 竖 限 栖 ， 采 静 艇 拦 “s:” 便 三 助 蛙 才 味 ， 传 姑 “s:string”。 

入 5-1 争 判 剖 父 玖 WSDL 话 禁 争 红 应 训 政 答 助 蛙 、 哈 味 竖 限 否 洋 丰 噢 。 
表 5-1 WSDL 常用 命名 空间 


前 缀 命名 空间 说 明 

XSD 务 哈 味 坚 限 ， 察 蜘 WSDL 娩 桥 争 企 诀 条 粮 
8: http://www.w3.org/2001/XMLSchema 

塌 细 乌 
soap: http://schemas.xmlsoap.org/wsdl/soap 晓 仪 SOAP 练 实 菇 哈 味 竖 限 
tm: http://microsoft.com/wsdl/mime/textMatching | 蛋 Microsoft 帝 挠 医 既 米 册 酯 拔 垄 茵 哈 味 竖 限 
soapenc: | http://schemas.xmlsoap.org/soap/encoding SOAP 1.1 实效 莫 Encoding 哈 味 竖 限 
mime: http://schemas.xmlsoap.org/wsdl/mime 了 罗 仪 WSDL MIME 统 宝 条 哈 味 竖 限 
tns: http://tempuri.org 很 助 Web 杷 义 技 黎 晓 匣 哈 味 竖 限 
http: http://schemas.xmlsoap.org/wsdl/http 聊 仪 WSDL 争 GET 哨 POST 综 宝 率 哈 味 竖 限 
wsdl: http://schemas.xmlsoap.org/wsdl WSDL 媚 禁 甸 才 讽 哈 味 坚 限 


definitions 二 绪 连 来 世 了 targetNameSpace 崔 个 , 圈 仪 的 实 窖 宇 凡 都 克 映 时 绪 撤 崔 柬 喻 咏 
竖 限 。 传 姑 ， 芍 助 兰 务 WSDL 婚 棒 争 ，targetNameSpace 崔 收 务 八 三 “http:/tempuri.org”， 还 
赋 从 眼 上 升 WSDL 婚 桂 争 撤 来 克 遇 入 守 颖 酝 崔 仪 http://tempuri.org 哈 味 竖 限 。 姑 杯 WSDL 既 述 
狸 都 柄 狼 影 蜡 迷 价 量 丝 ， 赋 怡 飓 寅 交 http://tempuri.org 哈 味 竖 限 。 


5.3.2 ”基础 知识 一 一 types 元 素 


types 外 物 里 艇 逻 仪 史 映 Web 权 鲸 争 逻 麟 许多 经 哨 粮 赴 ， 察 寺 隘 书 警 也 了 毕 羔 菊 XSD。 董 
可 了 守 财 凡 撤 来 条 XSD 旋 扬 粮 坟 酬 来 斤 ， 联 买 宣 齐 圈 抓 遗 速 担 岱 棺 渤 名表 角 共 妆 促 粮 址 网 颁 。 
柴 伪 邯 铸 4 笼 异 绰 伦 缩 连 XSD 粮 址 网 所， 过 伺 伪 WSDL 既 桥 订 圈 务 证 异 伦 缩 types 电 颖 
虹 讽 务 XSD 。 
俱 谚 ， 扭 作 显 C# 宝 雍 蕊 了 Person 缁 柠 ， 俱 硝 寻 艺 技 神 : 


public struct Person 


{ 


} 


窖 缮 柠 芍 types 电 始 争 医 XSD 裤 交 俱 硝 姑 艺 : 


public string Name; 


public DateTime Birthday; 


public bool isMarry; 


public decimal Height; 
public decimal Weight; 


< 


<wsdl:types> 
<s:schema elementFormDefault="qualified" targetNamespace=" 
http://tempuri.org/"> 
<s:element name="Person"> 
<s:complexType> 
<s:sequence> 
<s:element minOccurs="0" maxOccurs="1" name="Name™" 
type="xs:string" /> 
<s:element minOccurs="0" maxOccurs="]1" name="Birthday”" 
type="xs:date" /> 
<s:element minOccurs="0" maxOccurs="]1" name="isMarry" 
type="xs:boolean" /> 
<s:element minOccurs="0" maxOccurs="1" name="Height" 
type="xs:decimal" /> 
<s:element minOccurs="0" maxOccurs="]1" name="Weight" 
type="xs:decimal" /> 
</s:sequence> 
</s:complexType> 
</s:element> 
</s:schema> 
</wsdl:types> 


叶 俗 上 蜡 市 玖 达 针 伯 蜡 complexType 宇 盎 宝 雍 从 也 了 瘟 枞 粮 址 桃 寺 政 。 芭 types 守 络 争 高 枞 
粮 坟 f 履 侈 晓 杜 奶 务 ， 过 医 呈 三 芍 SOAP 原 谊 争 剧 妖 丛 大 枞 粮 坟 棺 “ 天 试 ” 吞 族 。 

types 守 几 藉 吕 世 了 伍 圈 蜂 三 message 守 疆 实 雍 吞 话 ， 联 买 示 姜 吞 旋 码 昕 洱 务 味 稣 瞪 周 ， 撑 
前 春 旋 创 妖 垄 昕 洱 务 味 稣 争 涡 知 “Response” 吧 蛙 。 

艺 兰 用 具 世 了 传 成 ， 傣 谚 来 姑 艺 俱 硝 拔 襟 条 Web 权 义 听 洱 : 

public User check (int id, string name, string pass) 

{ 


// 毁 黄 御 丫 昕 洱 条 寺 瑰 
} 


哮 俗 虐 厦 ， 迷 鲍 实 北 父 也 了 味 三 check 苍 昕 洱 ， 升 昕 洱 来 忒 了 吞 话 : 族 吉 id 吞 话 、 害 策 于 
粮 坟 name 吞 话 哨 害 策 于 粮 坟 pass 吞 话 。check 昕 洱 条 进 场 八 医 世 了 User 粮 坟 。 

棣 扬 助 其 展 types 宦 络 苗 伦 缩 ， 垄 杜 缤 医 WSDL 既 检 争 订 齿 来 世 了 味 三 check 郑 守 和 检 裤 
玄 昕 洱 拔 静 医 府 了 吞 旋 ， 吕 也 了 味 三 checkResponse 条 时 乡 棺 裤 雍 上 昕 洱 条 进 场 爹 。 联 买 带 价 坚 
经 桓 麻 容 实效 三 究 枞 迷 坦 ， 杜 缤 俱 硝 寻 艺 扳 禄 : 


<wsdl:types> 
<s:schema elementFormDefault="qualified" targetNamespace= 
"http://tempuri.org/"> 
<s:element name="check"> 
<s:complexType> 
<s:sequence> 
<s:element minOccurs="1"” maxOccurs="1"” name="id" type= 
"asint” /> 
<s:element minOccurs="0" maxOccurs="1" name="name" type= 


be i 
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<s:element minOccurs="0" maxOccurs="1"” name="pass" 
type="s:string" /> 
</s:sequence> 
</s:complexType> 
</s:element> 
<s:element name="checkResponse"> 
<s:complexType> 
<s:sequence> 
<s:element minOccurs="0" maxOccurs="1" name="checkResult" 
type="tns:User" /> 
</s:sequence> 
</s:complexType> 
</s:element> 
<s:complexType name="User"> 
<s:sequence> 
<s:element minOccurs="1" maxOccurs="1" name="id" type="s:int" /> 
<s:element minOccurs="0" maxOccurs="]1" name="name" type= 
aasring i 
<s:element minOccurs="0" maxOccurs="]1" name="pass" type= 
A 
<s:element minOccurs="]1" maxOccurs="]1" name="lasttime" type= 
"s:dateTime" /> 
</s:sequence> 
</s:complexType> 
</s:schema> 
</wsdl:types> 


$ 由 于 XSD 存在 很 多 个 版 本 ， 而 WSDL 规范 推荐 使 用 2001 版 本 。 因 此 为 了 使 用 这 
注意 | 个 版 本 ， 需 要 指定 命名 空间 为 “http://www.w3.org/2001/XMLSchema”。 


5.3.3 ”基础 知识 一 一 message 元 素 


message 宇和 盎 实 亥 从 Web 权 义 争 卡 旷 务 昕 洱 否 吞 旋 。 豁 守 结 内 艇 来 鳃 稠 眶 洱 : 世 稠 履 芍 type 
守 颖 争 宝 雍 听 洱 哨 吞 话 ， 侈 哆 芭 message 宇 络 争 影 曼 ; 吕 世 称 创 妖 睐 搁 芍 message 审 络 争 实效 
上 昕 洱 哨 吞 旋 。 
区 message 宇 绪 争 叶 俗 卡 嘱 姑 蔚 素 了 都 列 。 
@ name 崔 收 : 姑 杯 和 网 崔 个 务 铬 履 昕 洱 味 ， 创 匆 书 “SoapIm” 电 上 帅 圈 仪 瑶 固 淤 忱 ; 姑 杯 医 
昕 洱 味 创 知 书 “SoapOut”， 丰 遇 瞬 仪 缁 杯 偷 恼 。 达 针 薰 Soap 由 遇 过 鱼 了 淤 忱 伍 赵 仪 
SOAP。 寻 杯 虹 抓 典 垄 借 瞬 HTTP GET， 履 估 芍 上 昕 洱 咏 响 列 剧 适 知 “HttpGetm” 哨 
“HttpGetOut”。 
@ part 虹 几 条 name 发 收 : 展 part 虹 盎 详 name 崔 收 鉴 时 三 过 价 淤 居 粤 吞 旋 蜂 芍 书 苦 


types 时 几 争 实 雍 条。 
@ part 坚 缅 苍 element 岑 收 : 抢 崔 侦 遗 连 宝 玄 垄 毛 世 了 过 阑 哨 示 剖 洪 居 争 著 味 稣 检 影 圈 


会 姑 ， 展 仪 书 苞 剖 碧 条 check0 昕 洱 ， 察 条 message 审结 实效 姥 艺 : 


< 


(» 2b .服务 开发 学 习 实录 


<wsdl:message name="checkSoapIn"> 


<wsdl:part name="parameters" element="tns:check" /> 


</wsdl:message> 


<wsdl:message name="checkSoapOut"> 


<wsdl:part name="parameters" element="tns:checkResponse" /> 


</wsdl:message> 


可 人 握 钙 圈 秒 履 message 官 物 医 乏 也 称 上 虹 注 ， 直 垄 types 时 盎 争 贞 罗 ， 芍 message 官 络 争 


虹 。 姑 艺 拔 襟 三 合 圈 适 仁 笛 上 昕 肛 务 俱 硝 : 
<wsdl:types> 
<s:schema> 
<s:complexType name="User"> 
<s:sequence> 
<s:element minOccurs="1" 
"aint™ /> 


<s:element minOccurs= 
pe ee 
<s:element minOccurs="0" 
nassstring™ /> 
<s:element minOccurs="1" 
"s:dateTime" /> 
</s:sequence> 
</s:complexType> 
</s:schema> 
</wsdl:types> 
<wsdl:message name="checkSoapIn"> 


maxOccurs="1" 


maxOccurs="1" 


maxOccurs="1" 


maxOccurs="1" 


<wsdl:part name="id" type="s:int" /> 


<wsdl:part name="name" type: 


"s:string" /> 


<wsdl:part name="pass" type="s:string" /> 
<wsdl:part name="lasttime" type="s:dateTime" /> 


</wsdl:message> 
<wsdl:message name="checkSoapOut"> 


<wsdl:part name="result" element="s:User" /> 


</wsdl:message> 


5.3.4 ”基础 知识 一 一 portType 元 素 


name="id" type= 
name="name" type= 
到 


name="pass" type= 


name="lasttime" type= 


影 


portType 宇 盎 恬 WSDL 证 柳 争 杜 锌 艇 条 WSDL 宣 婕 产 也 , 察 掌 移 从 也 了 Web 杷 义 叶 复 控 


被 荔 捞 但 ， 俗 否 瞪 减 匣 淤 惰 。 


也 了 portType 答 宰 也 缠 扩 伍 (operation)， 联 迷 缠 捞 伍 官 颖 实效 鹤 portType 争 撤 来 听 洱 务 残 
洱 。 氨 了 operation 宦 盎 酬 卡 挨 昕 洱 粤 味 稣 、 吞 话 (message 宦 ) 哨 吞 旋 话 捐 粮 直 (message 艺 务 


part 由 他)。 


芍 世 了 WSDL 既 争 哮 俗 卡 呢 奶 了 portType 电 络 ， 联 氢 了 portType 宇和 绪 酝 卡 吵 世 缠 瞪 减 


= 他 -> 
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匣 提 全 。 奶 了 portType 家 络 产 限 侥 蜡 name 岑 个 棺 遏 祛 诽 列 ， 撤 从 察 伤 著 拿 怡 几 览 唆 世 茶 。 周 
梓 ，operation 坚 盎 条 name 岑 收 1 怡 赂 履 喉 世 ， 察 帮 列 周 世 了 portType 艺 医 奶 了 捞 伍 。 

operation 宇和 绑 侈 晓 input、output 哨 fault 宣 绑 棺 从 还 世 了 捍 位 。 察 伤 此 改 怡 静 务 ， 倩 姑 杯 
来 ，1 采 腺 剖 碧 世 现 。 味 军 绑 务 嘱 亥 姑 艺 。 

@ input 至 绑 : 虹 仪 侧 直 据 伍 医 逮 冻 ， 卡 挫 偿 羔 医 味 稣 哨 迷 坝 。 

@ output 官 丝 : 虹 仪 章 远 提 伍 务 逮 前 ， 卡 扒 进 剖 条 味 稣 哨 粮 翰 。 

@ fault 昌 绪 : 后 措 伍 剖 丽 欠 釜 晒 ， 呐 丛 曙 过 了 时 乡 的 实 条 杭 彤 持 距 。 

会 姑 ， 展 仪 助 苦 宝 雍 务 check 昕 洱 ， 察 庆 来 3 了 进 阑 吞 话 ， 刻 进 场 蕊 了 User 粮 坝 粤 缮 杯 。 
早 毁 ， 歼 党 哆 check 昕 洱 务 operation 守 几 凡 订 豁 周 晒 麻 来 input 审 缘 哨 output 时 纱 ， 俱 硝 姑 艺 
拔 神 : 

<wsdl:portType name="WebServiceSoap"> 

<wsdl:operation name="check"> 
<wsdl:input message="tns:checkSoapIn" /> 
<wsdl:output message="tns:checkSoapOut" /> 
</wsdl:operation> 
</wsdl:portType> 


过 人 扬 务 input 坚 乡 哨 output 守 绪 丁 呆 来 message 崔 个 ， 联 泽 来 name 崔 收 。 志 医 早 三 察 伤 元 
name 岑 收 符 艇 览 圈 但 寿 列 味 稣 瞪 周 ， 债 示 阑 哨 示 剖 此 周 粤 提 伍 。 俩 医 垄 过 人 饭 答 portType 官 络 
争 ， 有 果 来 蕊 了 提 伍 ， 撤 丛 泽 来 怡 舱 垄 mput 哨 output 坚 竹 争 侈 上 name 崔 悦 。 

传 寻 ， 歼 也 了 Web 权 义 争 卡 嘱 姑 艺 龟 了 钊 这 条 calc 昕 洱 : 


public int calc(int x, int Y) 
public float calc(float x, float Y) 


察 伤 列 剧 庆 来 int 哨 float 吞 话 。 时 毁 ， 很 垄 WSDL 既 述 争 侈 遇 达 了 Web 权 义 晒 ， 赋 静 角 
列 剧 上 克 贞 message 蛙 绪 哨 operation 侍 纱 。 过 者 列 倪 硝 姑 艺 拔 襟 : 


<wsdl:message name="calcIntSoapIn"> 
<wsdl:part name="parameters" element="tns:calcInt" /> 
</wsdl:message> 
<wsdl:message name="calcIntSoapOut"> 
<wsdl:part name="parameters" element="tns:calcIntResponse" /> 
</wsdl:message> 
<wsdl:message name="calcFloatSoapIn"> 
<wsdl:part name="parameters" element="tns:calcFloat" /> 
</wsdl:message> 
<wsdl:message name="calcFloatSoapOut"> 
<wsdl:part name="parameters" element="tns:calcFloatResponse" /> 
</wsdl:message> 
<wsdl:portType name="WebServiceSoap"> 
<wsdl:operation name="calc"> 
<wsdl:input name="calcInt" message="tns:calcIntSoapIn" /> 
<wsdl:output name="calcInt" message="tns:calcIntSoapOut"” /> 


</wsdl:operation> 


< 


<wsdl:operation name="calc"> 
<wsdl:input name="calcFloat" message="tns:calcFloatSsoapIn" /> 
<wsdl:output name="calcFloat" message="tns:calcFloatSoapOut" /> 
</wsdl:operation> 
</wsdl:portType> 
姑 书 冰 俱 硝 撤 襟 ，portType 电 络 争 卡 赔 钨 了 operation 宇 纤 ， 察 佑 条 name 崔 收 瞪 周 ， 酬 履 
calc。 三 从 大 列 察 伤 ， 昔 input 时 几 哨 output 宦 绑 争 侈 曙 name 岭 眉 拦 察 优 列 书 哈 味 三 calcInt 
哨 calcFloat。 


》 portType 元 素 在 binding 元 素 中 引用 ， 把 一 组 操作 绑 定 到 协议 。 而 这 些 操作 又 映射 
号 未 | ”到 binding 元 素 的 SOAP 操作 进行 调用 。 实际 上 ，portType 依附 于 协议 ， 将 操作 映 
射 到 SOAP 方法 , 这样 就 可 以 通过 WSDL 文档 的 服务 接口 定义 部 分 与 服务 实现 定 

义 部 分 进行 连接 


5.3.5 ”基础 知识 一 一 binding 元 素 


binding 电 颖 暴 仪 捣 宝 抽 但 侥 晓 医 佼 逮 碑 谊 、 应 草 印 昕 及 俗 否 咽 硝 机 有 彤 。 垄 WSDL 既 述 争 
医 助 3 了 莉 列 (types、message 哨 portType) 醒 区 伪 举 贻 昨 其 书 侈 罗 Web 权 勺 ， 联 binding 官 先 
必 睦 钠 耐 罗 族 摇 佼 过 务 狂 天 缮 苞 ，1 赋 蜂 站 binding 蛙 绪 蜂 展 助 3 了 痢 列 拔 俄 茵 河 伐 印 侈 中 。 

贞 件 垄 周 也 了 WSDL 既 桂 争 举 贻 宝 北 哨 洪 侯 丰 映 蜂 列 薄 茹 ， 联 买 WSDL 连 家 课 拦 举 贻 实 
雍 健 鹿 世 了 原 猫 苍 目 全 争 ， 移 响 侈 圈 import 是 妈 底 羔 市 杜 缤 医 WSDL 启 桂 争 。 过 茎 Web 权 义 
务 寺 了 天 咏 争 蜂 糙 应 来 圈 务 。 策 上 吕 周 务 葬 咏 喇 攀 咏 周 世 舟 粮 坟 秒 喇 惠 订 圈 稿 应 晒 ， 察 佑 叶 丛 实 
亥 世 你 档 剑 条 投 伍 ， 厂 拦 察 列 蚁 缆 味 了 静 咏 喇 ， 联 味 了 末 咏 唔 寺 政 味 稻 上 周 务 红 宝 。 攻 咏 幅 
Web 权 义 晒 ， 察 伤 叶 丛 拦 综 实 而 逻 碍 举 贻 实 刻 果 叭 趾 棺 ， 畔 扬 稻 幅 柬 WSDL 既 述 。 

传 寻 ， 叶 俗 三 疫 术 细 乌 实 币 也 娩 档 钊 捞 但 ， 达 寺 障 书 贤 也 了 WSDL 举 贻 饶 桂 ， 联 氨 了 彼 
桩 叶 俗 实 全 和 艰 幅 医 佼 人 冰 碑 谊 、 磨 剂 印 昕 有 彤 哨 署 硝 术 有 电 。 

三 父 材 姓 吉 由 上 遇 binding 坚 绪 粤 凡 系 ， 艺 其 从 绕 宝 书 区 前 碧 连 条 calc 昕 洱 三 传 。 达 莉 列 俱 
硝 娃 水 拔 禄 : 


<wsdl:binding name="WebServiceSoap" type="tns:WebServiceSoap"> 


<soap:binding transport="http://schemas.xmlsoap.org/soap/http" /> 
<wsdl:operation name="calc"> 
<soap:operation soapAction="http://tempuri.org/calcInt" style= 
"document" /> 
<wsdl:input name="calcInt"> 
<soap:body use="literal" /> 
</wsdl:input> 
<wsdl:output name="calcInt"> 
<soap:body use="literal" /> 
</wsdl:output> 
</wsdl:operation> 


<wsdl:operation name="calc"> 


mB >> 
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<soap:operation soapAction="http://tempuri.org/calcFloat™" style= 
"document" /> 
<wsdl:input name="calcFloat"> 
<soap:body use="literal™" /> 
</wsdl:input> 
<wsdl:output name="calcFloat"> 
<soap:body use="literal" /> 
</wsdl:output> 
</wsdl:operation> 

</wsdl:binding> 

姑 书 中 俱 硝 撤 襟 ，binding 是 络 争 茹 name 宕 眉 捣 实 练 实 茵 味 钱 三 “WebServiceSoap”。 姥 
杯 来 奶 了 binding 是 纱 ，name 崔 收 怡 赂 蜂 唆 世 务 。binding 时 财务 type 崔 侦 影 圈 世 了 portType 
守 纱 ， 芍 过 镀 三 “tns:WebServiceSoap”。 

搁 艺 检 务 “<soap:binding>” 牢 乡 的 裤 SOAP 淤 居 甸 痊 缸 原 谊 ， 速 祭 蜘 HITP。 吕 帮 ， 查 仪 
束 祭 学 四 条 Web 权 义 大 来 钊 这 条 calc 上 昕 洱 ， 撤 俗 芍 缚 寅 都 列 怡 赂 来 龟 了 operation 蛙 纱 ， 列 剧 
的 裤 察 伤 务 佼 进 原 谊 哨 淤 忱 杭 彤 。 大 列 察 伤 务 档 谢 恬 input 官 颖 争 医 name 岭 眉 , 列 鹿 三 calcInt 
哨 caleFloat。 

钨 了 operation 祁 颖 争 枉 来 也 了 soapAction 崔 侦 ， 察 务 八 路 世 了 URL。 筑 侈 曼 HTTP 佼 迟 
SOAP 淤 居 晒 赋 舍 侈 罗 SOAPAction HTTP 仇视 噢 抢 SOAP 苇 渍 务 晒 酌 ， 权 义 喷 呐 俗 要 扬 速 了 
HTTP 做 侩 居 佼 谴 SOAP 淤 忱 。operation 柬 soapAction 岑 收 赋 蜂 的 上 昨 瑶 圈 志 了 投 伍 晒 SoapAction 
众 订 齿 详 户 务 斜 。 

可 僻 鲁 了 operation 宇 结 争 soapAction 条 斜 此 周 ， 姑 杯 艇 瑶 圈 “public int calc(int x, int y)”， 
创 静 艇 侥 虚 小 其 医 HTTP 从 : 


SORAPRction: " http://tempuri.org/calcIint " 
联 姑 杯 艇 瑶 畴 “public float calc(float x, floaty)”， 创 侈 圈 条 HTTP 麻吉 三 


SOAPAction: " http://tempuri.org/calcFloat " 


binding 争 世 operation 坚 缅 哨 portType 争 茹 operation 电 络 粮 侯 ， 哮 俗 卡 嘱 input、output 
哨 fault 坚 纱 ， 倩 达 饶 条 过 3 笛 守 绪 此 的 宝 揽 伍 务 淤 忱 ， 联 鉴 的 实 淤 忱 粤 栅 赔 。 芍 速 了 传 成 争 ， 
operation 写 乡 争 下 来 input 守 绪 ( 进 阑 ) 吟 来 output 时 绪 (过 剖 )， 察 伤 遗 速 味 稻 茶 name 岑 个 大 列 
履 商 了 投 伍 。 
毁 者 , 理 仪 侈 曼 务 蜂 SOAP 综 宝 , 撤 俗 垄 input 至 乡 争 侈 旺 “<soap:body> ” 守 检 捣 宝 SOAP 
淤 恼 争 body 审 颖 凡 允 薰 栅 及。body 坚 乡 岂 角 来 3 了 崔 收 ， 姑 艺 撤 襟 。 
@ use: 毁 岭 例 晓 梯 捣 实 族 搞 览 encoded 连 恬 literal。literal 和 祁 禄 SOAP 淤 居 争 卡 嘱 条 话 
扩 呆 苔 签 原 吉 近 燃 举 贻 实效 都 列 薰 钥 渍 遏 被 枫 腑 如 ;， 联 encoded 创 入 襟 侈 旺 
encodingStyle 崔 帆 钊 实话 摇 共 署 硝 杭 及 。 
@ namespace: 氯 了 SOAP 淤 剧 条 body 都 列 醒 叶 俗 来 稻 幅 务 啥 吃紧 限 。 
@ encodingStyle: 速 蜘 世 了 URL 拿 ， 圈 仪 的 宝 SOAP 汶 忱 粤 署 硝 刘 创 。 姑 杯 侈 因 SOAP 
厂 谊 争 实效 薰 署 硝 鹿 | 创 ， 创 麻 夫 蜂 http://schemas.xmlsoap.org/soap/encoding。 
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5.3.6 ”基础 知识 一 一 service 元 素 


也 了 service 宇 绑 叶 俗 理 奶 了 port 审 络 缠 扬 , 氨 了 port 宇 绪 酬 三 世 了 binding 官 络 捣 实 也 了 
谤 隐 吉 操 。 姑 杯 奶 了 port 宇 几 周 晒 三 蕊 了 binding 宇 绪 的 实 上 岂 周 备 圳 壤 ， 郭 达 价 吉 霹 争 笨 伦 伏 
世 了 酝 叶 侈 圈 。 

区 也 了 WSDL 眠 检 争 遗 应 呆 侈 上 罗 世 了 service 宇 盎 , 后 焚 人 1 哮 俗 来 奶 了 service 虹 盎 。 传 姑 ， 
陵 俗 要 扬 佼 进 原 谊 拦 撤 来 和 HTTP POST 侍 淹 世 了 service 电 丝 争 ; 联 撤 来 和 SOAP 等 淹 吕 世 了 
争 ， 寺 抓 { 叶 丛 侈 圈 稻 幅 斋 挠 务 原 谊 棺 摸 绒 service。 

艺 苦 缆 训 也 了 味 三 WebService 共 service 时 几 务 凡 系 。 拾 守 乡 卡 呢 也 了 咏 三 WebServiceSoap 
条 port 宇 络 ， 瞪 麻 条 引 宝 三 WebServiceSoap，SOAP 练 实 攻 圳 圳 三 “http://localhost/WebSite/ 
WebService.asmx”。 


<wsdl:service name="WebService"> 
<wsdl:port name="WebServiceSoap" binding="tns:WebServiceSoap"> 
<soap:address location="http://localhost/WebSite/WebService.asmx" /> 
</wsdl:port> 
</wsdl:service> 


5.4 ”查询 域名 IP 地 址 


姑 保 术 链 世 了 逮 吸 展厅 攻 人 P 圳 吉 ? 

展 仪 速 了 隐 险 ， 瞪 丛 受 焕 Web 莱 咏 务 依 醒 舍 站 ， 过 虱 签 愿 品 ， 来 必 奶 帧 谍 哮 俗 寺 政 。 杜 
签 原 苑 赋 蜂 侈 因 “ping 录 味 ” 哈 侣 检 格 上 旺 。 

便 三 世 味 稿 订 藉 蚁 依 哎 ， 扭 佑 筷 作 人 驴 圈 稿 应 条 昕 赂 检 试 旬 束 也 隐 馈 。 阅 寺 ， 瞎 稚 世 焕 1 
此 替 。 虐 瞄 扭 LI 全 怡 交 梓 吃 ， 连 暗 刻 父 Web 权 义 哮 。 


A 
上 视频 教学 : 光盘 /videos/05/ 查 询 域名 下 地 址 .avi 人 @@ 长 度 :12 分钟 


5.4.1 基础 知识 一 一 WSDL 文档 的 使 用 方式 


扭伤 垄 招 庆 Web 权 义 条 WSDL 如 禁 产 呢 ， 芝 应 来 鱼 笛 侈 圈 昕 肛 ， 速 鱼 笛 上 昕 彤 酬 览 稿 应 网 
苗 别 瞬 ， 卫 硅 医 Web 幕 蚁 估 旷 采 静 控 拱 寻 保 侥 晓 走 哮 ， 泽 来 怡 艇 陡 帮 擒 队 政 就 察 。 

第 世 舟 上 昕 及 蚁 圈 垄 萍 蚁 晒 ， 玉 依 哆 要 扬 WSDL 妍 枯 睦 扬 貌 逻 Web 杷 义 医 对 抓 筋 保 硝 。 
传 姑 ， 董 迷 仿 助 其 格 侈 圈 wsdl 哈 侣 圈 扬 达 梓 医 对 抓 筋 保 硝 ， 丰 应 1 复 稣 三 Web 权 义 俱 天 粮 。 

烽 岗 ， 垄 署 LI 对 抓 筋 订 晓 稿 庭 医 连 稿 争 ， 贱 睐 搁 爹 暴 Web 权 义 俱 天 粮 ， 赋 信 侈 圈 从 贡 粮 
也 梓 ， 联 寺 障 条 Web 杷 义 狐 曼 咏 圈 垄 俱 天 粮 昌 Web 权 义 产 限 。 姥 坚 5-3 拔 襟 侈 曼 过 笛 上 昕 展 天 
连 稿 。 


Eee 全) >> 
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客户 端 调用 Web 服 务 的 | 
返回 结果 返回 结果 


5-3 ”开发 时 使 用 WSDL 文档 的 过 程 


逢 仁 舟 昕 彤 览 捣 芍 稿 麻 进 被 晒 爹 圈 WSDL 放 枯 。 毁 旺 ， 对 抓 筋 订 固 稿 应 遗 速 察 拔 芮 务 进 
祛 形 龙 蛇 剖 展 Web 权 义 务 狐 圈 ( 传 姑 , 侈 罗 SOAP Toolkit 务 寺 抓 筋 缠 亿 ), 进 被 玖 妄想 所 WSDL 
电 禁 曙 扬 殿 舌 条 Web 权 义 瑶 圈 刻 浅 ， 广 搁 吴 Web 权 义 进 场 条 杯 ， 侨 响 拦 绪 杯 佼 诞 缆 对 抓 筋 
麻 晓 稿 床 。 旋 了 连 稿 寻 坚 5-4 撤 襟 。 


对 抓 筋 进 被 到 户 本 WSDL 媚 桩 本 Web 权 久 


瑶 圈 昕 洱 


图 5-4 ”运行 时 使 用 WSDL 文档 的 过 程 


5.4.2 ”实例 描述 


昼 诅 钙 晓 商 舟 昕 彤 侥 上 虹 WSDL 妍 梭 ， 盎 客 来 卫 焕 怡 确 丛 良 ， 忆 贱 敬 脉 效 踪 连 也 了 URL 棺 
详 隐 Web 权 义 。 伪 联 朱 来 叶脉 营 吧 扮 险 上 里 扬 WSDL 既 树 ， 搁 艺 梯 创 几 垄 更 咏 扮 险 进 被 晒 朋 虹 
Web 杷 义 。 

艺 苦 ， 扭 优 遗 束 世 了 杭 答 寻味 人 P 葡 霹 医 寺 传 梯 谎 率 姥 保 垄 稿 应 进 被 晒 爹 暗 WSDL 婚 要 狐 
虹 Web 权 义 。 垄 灯 寺 传 争 ， 扭 休 医 对 抓 筋 麻 晓 稿 应 屡 钙 上 虹 VBScript 检 署 L1， 麻 侯 毁 早 姑 艺 。 


5.4.3 ”实例 应 用 
【 传 $-2】 杭 从 建 味 下 黄 霹 
(1) 区 IIS 书 昌 条 也 了 味 三 “Service” 琳 蜡 挺 明 德 ， 屋 盖 虹 导 误 华 圳 仍 名 叭 书 天 世 了 旗 侠 


媳 。 传 姑 ， 昔 系 寺 传 争 履 “E:\myRoot\Service”。 
(2) 垄 Service 虹 挺 肯 德 艺 剧 条 世 了 Web 权 义 如 癸 ， 啥 味 三 “DomainService.asmx”。 


< 


二 服务 开发 学 习 实录 .条 


(3) 圈 诺 大 柴 担 萍 DomainService.asmx 婚 侠 遏 祛 署 迭 , 济 勿 姑 艺 俱 硝 贞 映 世 了 Web 权 久 ， 
证 影 辣 撤 静 答 哈 咏 竖 限 。 

<$%Q@ WebService Language="C#" Cl1ass="DomainService.DomainSearch " %> 

using System; 

using System.Web; 

using System.Web.Services; 

using System.Net; 


(4) 搁 沙 枪 ， 央 象 哈 味 竖 限 哨 Web 权 义 粮 ， 厂 展 粮 歇 祛 到 毁 即 。 倪 硝 姑 艺 拔 禄 : 


namespace DomainService 

{ 
[WebService (Namespace = "http://tempuri.org/")] 
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfilel 1)] 
public class DomainSearch : System.Web.Services.WebService 
{ 
} 

} 


(5) 刺 蕉 三 DomainSearch 粮 济 各 Web 权 义 上 昕 洱 ， 第 世 了 GetTimeO 昕 洱 乾 场 指 助 旺 机 哨 
晒 限 条 害 策 于 。 寺 丽 俱 硝 姑 艺 : 
/// <summary> 
/// 营 呵 指 助 时 村 哨 晒 限 
/// </summary> 
/// <returns> 和 游 场 也 了 害 策 于 枫 肝 医 晃 相 哨 晒 限 全 </returns> 
[WebMethod (Description = " 营 呵 和 把 助 是 术 哨 晒 限 ") ] 
public String GetTime() { 
return DateTime.Now.ToString(); 


| 
(6) 风 济 知 也 了 椒 所 举 味 术 竺 瑟 幸 霹 务 GettPForNameO 昕 洱 ， 寺 政 俱 硝 姑 艺 : 


/// <summary> 

/// 营 呵 捣 宝 迷 味 医 IP 吉 卉 

/// </summary> 

/// <param name="strName"> 钥 检 符 医 津 味 </param> 

/// <returns> 游 场 尝 味 展 魔 医 IP 贡 操 </returns> 

[WebMethod (Description = " 营 吗 捣 实 尝 味 莫 IP 坦 堪 ") ] 

public String GetIPForName (string strName) { 
IPHostEntry info = Dns.GetHostEntry(strName); 
return info.AddressList[0] .ToSstring(); 

E 


(7) 骨 毁 ，Web 杷 义 医 保 硝 赋 嗜 LI 寨 狼 ， 丛 宴 展 察 薰 俩 澜 。 艺 车 出 象 对 抓 筋 谭 晓 稿 应。 周 
梓 圈 诺 大 柴 棺 署 L1， 昌 条 世 了 味 夺 “wsdlLvbs” 杀 媚 侠 俊 宴 市 柴 圳 散 句 噬 条 要 明 德 。 佑 站 ， 苑 
业 寺 传 争 监 “D:\”。 

(8) 椒 据 Web 权 义 条 WSDL 既 涟 用 眶 GetTime0 昕 洱 哨 GetPForName0 昕 洱 , 厂 示 痢 绪 杯 。 
寺 丽 俱 硝 姑 艺 撤 禄 : 


mS) >> 
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SET myService=CreateObject ("MSSOAP.SOAPClient") 

myService.mssoapinit "http://localhost/Service/DomainService.asmx?WSDL" 
t=myService.GetTime() 

ip=myService.GetIPForName ("www.itzcn.com") 

WScript .Echo "寻味 梅 答 庶 德 " 

WScript.Echo " 
WScript.Echo " 析 签 晒 限 : "&t 
WScript.Echo " 析 签 巡 味 :www.itzcn-comn" 
Wscript.Echo " 柏 答 杯 : "gip 


(9) 丛 宴 对 抓 筋 稿 话 wsdl.vbs， 乞 其 展演 过 被 迫 被 厂 梅 上 蜡 弹 杯 。 


5.4.4 ”运行 结果 


到 演 说 吹 争 逮 羔 吉 圳 “http://localhost/Service/DomainService.asmx ”， 检 上 蜡 Web 权 义 
DomainService 医 吓 怖 伍 殿 应 ， 进 被 咒 斤 杯 寻 坚 5-5 拔 禄 。 

茎 可 祭 儿 前 父 书 苦 裤 雍 务 龟 了 上 昕 洱 。 原 划 * 权 义 岂 上 ? 针 搁 检 析 具 猎 展 趾 Web 权 义 攻 WSDL 
眠 桂 ， 担 荧 响 甸 苞 其 姑 坚 5-6 拔 禄 。 


.org/wsdl/ sonp32/， 
schemas.xmlsoap.org/ wsdl/http/" 
‘tps/ /tompuri.org/" 

此 Web 服务 合用 http://tempurl.org/ 件 为 各 认 刘 各 空间 。 

合议 ; 公开 XML Web services 之 前 ， 请 更 殉职 认 低空 


5-5 查看 Web 服务 DomainService 图 5-6 查看 DomainService 的 WSDL 文档 


遗 连 坚 5-5 哨 坚 5-6 由 上 遇 削 条 务 Web 权 义 进 被 典 应 。 连 哮 俗 垄 坚 5-5 披 襟 粤 阁 荨 争 展 昕 洱 
歇 祛 润 谱 。 艺 将 检 瞄 瞄 姑 促进 祛 对 抓 科 稿 应 过 被 润 谱 。 

进 祛 “CMD” 哈 但 担 莫 喻 侣 搅 制 时， 厂 剑 换 前 wsdl.vbs 拔 垄 条 D 易 骸 义 只 。 

奖 员 ， 撑 羔 “cscript.exe wsdl.vbs” 哈 谷 枪 进 被 ， 寨 扬 骂 佑 眶 鹿 偿 训 弹 杯 ， 寻 坚 5-7 拔 禄 。 


图 5-7 运行 结果 


@@ ” 为 了 确保 本 程序 能 正常 运行 ， 读 者 需要 安装 一 个 客户 端 访 问 Web 服务 的 工具 包 ， 
注意 即 SOAP Toolkit3。 该 包 可 在 微软 官方 网 站 下 载 。 


5.4.5 “实例 分 析 


ra 


在 本 实例 中 ， 我 们 采用 记事 本 来 编写 Web 服务 以 及 调用 它 的 客户 端 应 用 程序 ， 然 后 在 命 
令 行 下 执行 并 查看 输出 结果 。 整 个 过 程 不 需要 借助 其 他 编辑 器 或 者 开发 工具 。 

但 是 要 注意 ， 为 了 使 客户 端 能 正确 访问 Web 服务 ， 必 须 将 Web 服务 放 在 IIS 下 。 另 外 ， 
由 于 客户 端 应 用 使 用 的 是 WSDL 文档 , 还 要 确保 Web 服务 的 WSDL 能 正常 浏览 。 测试 的 方法 
是 ， 在 浏览 器 中 输入 Web 服务 的 URL 并 加 入 “?WSDL” 后 级 。 

在 客户 端 应 用 程序 中 使 用 “CreateObject("MSSOAP.SOAPClient")” 语 身 创 建 了 一 个 SOAP 
Toolkit 的 客户 端 对 象 ， 接 下 来 指定 WSDL 文档 的 URL 来 初始 化 这 个 对 象 。 再 往 下 就 是 调用 
Web 服务 中 的 方法 并 显示 结果 。 


5.5 ”常见 问题 解答 


5.5.1 关于 自 定义 WSDL 的 问题 


关于 自 定义 WSDL 的 问题 ? 
网 络 课堂 : http://bbs.itzen.com/thread-15739-1-1.html 


圈 Visual Studio 剧 和 Web Service 估 稻 句 转 扬 WSDL。 璨 芍 扭 恒 圈 稻 幅 的 实务 WSDL， 扭 
蔬 恪 交 估 ? 恪 交 征 时 WSDL 既 快 蜂 扬 ? 恪 交 圈 稻 宝 雍 条 WSDL 媚 亿 ? 
【 斌 包 勺 洱 】 
傣 详 WebService 柬 味 害 蜂 MyWebService。 
(1) 拦 稻 宝 玄 WSDL 眠 代 刍 齐 MyWebService.asmx 上 世代 技 芍 条 明知。 
(2) 区 MyWebService 粮 书 知 书 [WebServiceBinding] 宪 届 档 佣 。 
[WebServiceBinding (Name = "MyBinding", Location = "MyCustom.wsd1")] 
public class MyWebService : WebService 
{ 
DA 
} 


MyBinding 览 垄 WSDL 记 仙 争 实 雍 条 binding 匣 味 害 ，MyCustom-wsdl 览 稻 实效 WSDL 
电 人 饼 。 


(3) 区 WebService 昕 洱 书 匆 书 [SoapDocumentMethod] 岭 收 档 艇 。 


mB >> 


[WebMethod] 


Binding="MyBinding")] 


[SoapDocumentMethod (Action="http://tempuri.org/HelloWorld", 
public string HelloWorld() { 

We 

} 


第 5 章 Web 服务 描述 语言 


毁 针 薰 实效 。 达 梓 贱 叶 俗 侈 晓 艇 实 北 攻 WSDL 伯 。 


迷 技 Action 览 芍 WSDL 既 快 争 实效 世 operation 虹 络 务 soapAction 圳 过 ，Binding 周 第 也 
趣 品 柬 和 欲 ， 会 诽 寨 扬 迷 飓 慎 令 佑 忻 咏 勒 。 


图 


[Le 


杜 纲 ， 搬 神 卫 学 镍 稻 宾 浆 WSDL 既 人 快 叶 此 览 卫 候 参 景 医 夫 愧 ， 寻 杯 售 上 蜡 此 台 WSDL 瞪 减 
5.5.2 ”如 何 处 理 WSDL 中 的 复杂 类 型 
有 


如 何 处 理 WSDL 中 的 复杂 类 型 ? 
网 络 课堂 : http://bbs.itzen.com/thread-15738-1-1.html 
englishName。 


price; 联 吕 世 了 瘟 枞 粮 直 productName 览 name 苯 粮 吉 ， 来 鱼 了 成 蛙 几 : chineseName 哨 
鄂 交 LI WSDL 了 晒 姑 促 L 哮 ? 
艺 辩 务 三 促 交 佑 剖 蚀 : 


<types> 


<xsd:schema 


俱 谚 克也 了 WSDL 争 来 龟 了 廊 枞 粮 直 ， 也 了 三 product， 亡 守 几 列 剧 三 name、description、 


targetNamespace= "http://www.ecerami.com/schema " 
xmlns= "http://www.w3.org/2001/XMLSchema "> 
<xsd:complexType 

<xsd:sequence> 


name= "productName "> 
<xsd:element 


name= "chineseName " 
<xsd:element name= "englishName " 
</xsd:sequence> 
</xsd:complexType> 
<xsd:complexType 


type= "xsd:string "/> 
type= "xsd:string "/> 
name= "product "> 
<xsd:sequence> 
<xsd:element 


<xsd:element 


name= "name " type= "xsd:productName "/> 
name= "description " 
<xsd:element name= "price 
</xsd:sequence> 
</xsd:complexType> 

</xsd:schema> 
</types> 


type= "xsd:string "/> 
type= "xsd:double "/> 


< 
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搬 襟 剖 镀 姑 艺 : 
Type {http://www.w3.0rg/2001/XMLSchema}productName is referenced but 
not defined. 


【 试 馈 勾 洱 】 
换 扬 艺 粹 条 俱 硝 谱 谱 ， 麻 秀 叶 丛 试 馈 停 务 隐 蔡 。 


<xsd:schema 
targetNamespace= "http://www.ecerami.com/schema " 
xmlns= "http://www.w3.0org/2001/XMLSchema " 
xmlns:my= "http://www.ecerami.com/schema "> 


<xsd:element name= "name " type= "my:productName "/> 


5.6 习 题 


一 、 填 空 题 
(1) 假设 有 一 个 Web 服务 的 地 址 为 “http:Wlocalhost:1025/s/testasmx” ， 那 么 可 以 通 
过 地 址 查看 它 的 WSDL 文档 。 
(2) 一 个 WSDL 文档 的 根 元 素 是 5 
(3) 在 WSDL 文档 的 部 分 中 指定 了 访问 Web 服务 实例 所 需 的 传输 协议 。 
(4) 一 个 WSDL 文档 中 可 以 没有 元 素 ， 但 是 如 果 有 只 能 出 现 一 次 。 
(5) 假设 有 一 个 名 为 getTime() 的 Web 服务 方法 ,那么 在 types 元 素 中 的 元 素 用 
于 定义 输入 ， 元 素 用 于 定义 输出 。 
(6) 使 用 definitions 元 素 的 属性 可 以 指定 该 元 素 内 部 声明 元 素 所 属 的 命名 
空间 。 
二 、 选 择 题 
(1) WSDL 是 一 个 基于 的 文档 ， 它 描述 了 Web 服务 各 个 方面 的 元 素 。 
A. XML B. XSD C. SOAP D. HTTP 
(2) 下 面 给 出 的 元 素 中 不 属于 WSDL 文档 的 是 
A. types B. description C. message D. binding 
(3) 下 面 元 素 中 不 属于 WSDL 文档 的 服务 接口 定义 部 分 的 是 
A. types B. message C. binding D. portType 
(4) 关于 各 个 元 素 在 WSDL 文档 中 出 现 的 先后 顺序 ， 下 面 正确 的 是 


mB >> 


A. binding.、 message、 portType、 service、 type 
B. message、 binding、 type、 portType、 service 
C. service、 type、 portType、 binding、 message 
D. type、 message、portType、binding、service 
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(5) 下 面 命名 空间 中 不 属于 definitions 元 素 的 是 5 
A. http://www.w3.org/2001/XMLSchema 
B. http://schemas.xmlsoap.org/wsdl/soap 
C. http://microsoft.com/wsdl/mime/textMatching 
D. http://www.wsdl.com/schema 

(6) 对 于 getTime() 方 法 在 message 元 素 中 的 name 属性 ， 下 面 不 合法 的 是 风 
A. getTimelIn 和 getTimeOut 
B. getTimeSoapIn 和 getTimeSoapOut 
C. getTimeHttpGetIn 和 getTimeHttpGetOut 
D. getTimeHttpPostIn 和 getTimeHttpPostOut 

(7) 对 于 下 面 给 出 的 代码 ， 描 述 不 正确 的 是 

<wsdl:service name="WeatherService"> 

<wsdl:port name="WeatherServiceSoap" binding="tns:WeatherServiceSoap"> 

<soap:address location="http://www.itzcn.com:808/WeatherService.asmx" /> 


</wsdl:port> 
</wsdl:service> 


A. SOAP 绑 定 地 址 为 “http://www.itzcn.com:808/WeatherService.asmx” 
B. 肯定 有 一 个 名 为 WeatherServiceSoap 的 port 元 素 


C.，port 元 素 绑 定 的 为 WeatherServiceSoap 
D. port 元 素 绑 定 的 为 tns:WeatherServiceSoap 


三 、 上 机 练习 


上 机 练习 1: 根据 Web 服务 编写 WSDL 文档 。 

本 章 详细 介绍 了 WSDL 文档 的 查看 方法 、 组 成 部 分 以 及 每 个 元 素 。 在 本 次 上 机 练习 中 要 
求 读者 根据 描述 的 Web 服务 编写 WSDL 文档 ， 最 后 在 浏览 器 中 查看 结果 。 

假设 有 一 个 名 为 WeatherRetriever 的 Web 服务 ， 其 中 有 一 个 名 为 GetTemperature 的 方法 ， 
该 方法 的 声明 如 下 : 

public float GetTempearture (string zipCode) 


Web 服务 的 位 置 是 http://www.mywebservice.com/WeatherRetriever.asmx。 
现在 ， 为 了 使 用 这 个 Web 服务 ， 要求 编写 针对 它 的 WSDL 文档 。 


< 
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内 容 摘 要 : 

Internet 的 发 展 需 要 商家 提供 给 客户 更 好 、 更 有 效 的 网 络 服务 。 以 前 的 软件 开发 技术 使 得 
商业 应 用 程序 之 间 的 通信 十 分 困难 。 比 如 操作 系统 、 程 序 语言 、 对 象 模型 等 各 种 各 样 资源 的 使 
用 ， 会 给 软件 开发 人 员 带 来 很 大 的 挑战 。 

Web 服务 可 以 用 来 解决 不 同 操作 系统 、 程 序 语言 和 对 象 模型 等 对 象 与 应 用 程序 之 间 的 通信 
问题 。Web 服务 之 所 以 能 够 很 轻松 地 解决 这 个 问题 ， 依 赖 于 Internet 标准 的 有 力 支持 。 其 中 包 
括 HTTP( 超 文本 传输 协议 )、XML( 可 扩展 标记 语言 ) 和 SOAP( 简 单 对 象 访问 协议 ) 等 。 

Web 服务 主要 在 Internet 环境 中 使 用 ， 而 Internet 环境 中 存在 着 各 种 各 样 的 平台 和 技术 。 
因此 ，ASP.NET 默认 所 使 用 的 SOAP 消息 格式 可 能 因为 与 其 他 语言 的 实现 不 同 而 不 完全 兼容 。 
所 以 ， 我 们 就 可 以 对 Web 服务 使 用 的 SOAP 消息 进行 修改 ， 以 更 好 地 与 其 他 语言 的 应 用 程序 
和 平台 进行 通信 。 

本 章 ， 我 们 就 来 深入 研究 ASPNET Web 服务 中 SOAP 协议 的 应 用 。 

学 习 目标 : 

@ 了 解 SOAP 的 数据 格式 
了 解 SOAP 的 编码 数据 类 型 
了 解 SOAP 的 RPC 规定 
掌握 SOAP 扩展 的 使 用 方法 
掌握 定制 SOAP 消息 的 方法 
熟练 使 用 Web 服务 传输 复杂 的 数据 对 象 


6.1 全面 认识 SOAP 


SOAP 是 Web 服务 交换 XML 信息 的 标准 协议 。 一 般 来 说 ，SOAP 是 一 种 用 XML 封装 信 
息 的 机 制 。 对 于 Web 服务 来 说 ，SOAP 主要 用 于 通过 XML 来 封装 并 传递 方法 以 及 参数 ， 进 行 
Web 调用 (或 者 说 远程 方法 调用 ，RPC)。 

下 面 先 来 对 SOAP 进行 一 个 初步 的 了 解 。 这 里 我 们 会 针对 SOAP 的 优势 、SOAP 的 格式 等 
方面 对 SOAP 进行 一 个 简单 的 介绍 。 


A 
加 视频 教学 : 光盘 /videos/06/ 全 面 认识 SOAP.avi 人 @@ 长 度 :28 分钟 


SOAP(Simple Object Access Protocol， 简 单 对 象 访问 协议 ) 是 一 种 传输 协议 。 它 不 仅 支 持 分 
布 式 应 用 程序 的 远程 方法 调用 , 也 支持 各 种 复杂 类 型 数据 的 传递 , 以 及 对 任意 负载 的 消息 处 理 。 
由 于 微软 对 SOAP 的 大 力 支持 ， 而 且 .NET Framework 对 其 提供 了 良好 的 支持 ， 所 以 很 多 
人 会 误 认 为 SOAP 是 Microsoft 的 专利 。 虽然 初期 确实 微软 投入 了 不 小 的 精力 ， 但 是 SOAP 的 
设计 目的 就 是 在 各 供应 商 和 平台 之 间 建 立 一 个 零 耦 合 的 协议 , 所 以 SOAP 是 独立 于 系统 、 硬 件 、 
软件 、 网 络 等 的 一 个 标准 。 


6.1.1 基础 知识 一 一 为 什么 我 们 要 使 用 SOAP 


为 了 能 够 轻松 地 理解 SOAP， 下 面 来 看 一 下 相对 于 传统 的 网 络 应 用 ，SOAP 给 我 们 带 来 了 
哪些 惊喜 。 

自 20 世纪 90 年 代 开 始 , Intemet 有 了 非常 迅猛 的 发 展 。 Internet 使 用 TCP/IP 协议 把 成 千 上 
万 的 计算 机 连接 起 来 。 基 于 这 种 底层 的 网 络 连接 ， 网 络 中 诞生 了 许多 类 型 的 网 络 应 用 ， 比 如 
Web、FTP、Email 等 。 但 在 建立 这 些 网 络 应 用 时 ， 通 常 是 基于 TCP 协议 ， 为 它 建立 一 种 专门 
的 应 用 程序 协议 (比如 HTTP 是 专门 应 用 于 Web 服务 器 和 客户 端 之 间 的 应 用 程序 通信 协议 )， 
图 6-1 展示 了 这 种 应 用 程序 的 协议 栈 。 


Web 客 户 端 Web 服 务 器 端 


6-1 Web 应 用 程序 协议 栈 


虽然 Web 已 经 在 Intemet 应 用 领域 取得 了 绝对 的 领导 地 位 , 但 是 它 只 能 使 用 相当 简单 的 命 
令 ( 如 GET、POST、DELETE 等 ) 来 请 求 和 发 送 数据 。 所 以 ， 虽 然 Internet 有 很 大 的 应 用 潜力 ， 
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但 是 在 使 用 Web 来 实现 一 些 网 络 应 用 的 时 候 不 能 够 很 方便 地 在 应 用 程序 之 间 自 由 地 交换 数据 
及 共享 信息 。 

Internet 的 这 种 棘 端 推 动 了 SOAP 的 诞生 。 SOAP 是 一 个 简单 的 协议 , 使 用 它 可 以 在 不 同 的 
应 用 程序 之 间 方 便 地 交换 数据 。SOAP 可 以 基于 HTTP 实现 应 用 程序 间 的 通信 ， 也 可 以 基于 
TCP/IP 实现 应 用 程序 间 的 通信 。 


5 实际 上 SOAP 协 议 可 以 基于 Intermet 上 的 任何 传输 协议 来 实现 应 用 程序 到 应 用 程序 
提示 | 。 间 的 通信 。 


SOAP 协议 和 HTTP 都 是 一 种 应 用 程序 级 的 协议 ， 因 此 它们 可 以 直接 建立 在 其 他 传输 协议 
之 上 (比如 TCP)。 在 Intemet 中 ， 网 络 中 一 般 会 有 防火 墙 等 安全 系统 的 介入 ， 而 且 它们 通常 只 
允许 HTTP 协议 通过 。 传 统 的 应 用 程序 通信 对 防火 墙 等 安全 设备 进行 了 一 些 特殊 的 设置 ， 所 以 
我 们 还 必须 考虑 应 用 程序 通信 的 安全 问题 。 所 以 我 们 可 以 将 SOAP 建立 在 HTTP 协议 基础 之 上 ， 
实现 应 用 程序 的 通信 。 图 6-2 中 显示 的 是 传统 应 用 程序 和 使 用 建立 在 HTTP 协议 之 上 的 SOAP 
的 网 络 通信 示意 图 。 


6-2 ”传统 的 网 络 通 信和 基于 HTTP 的 SOAP 协议 通信 


SOAP 是 一 个 非常 优秀 的 小 型 协议 ,使 用 该 协议 不 需要 在 发 送 方 和 接收 方 进行 大 量 的 工作 。 
因为 SOAP 使 用 构造 的 XML 作为 其 数据 编码 格式 ， 所 以 任何 只 要 能 解析 XML 的 系统 都 能 够 
通过 SOAP 通信 。 

翻 开 历史 我 们 会 发 现 , SOAP 并 不 是 第 一 个 尝试 把 RPC 和 文档 交换 机 制 标准 化 的 ,当然 也 
不 会 是 最 后 一 个 。 在 RPC 领域 ， 先 前 的 COM/DCOM 等 组 件 都 想 实 现 这 个 功能 ， 但 是 它们 在 
Internet 上 的 工作 性 能 不 太 完 善 。 

SOAP 之 所 以 这 么 重要 , 是 因为 它 已 经 被 业界 所 有 主要 参与 者 所 支持 , 从 最 开始 的 IBM 和 
Microsoft， 到 最 近 的 Sun Microsystems。 当 然 ，SOAP 的 非 同 凡响 还 需要 有 大 量 相关 的 标准 的 
广泛 支持 ， 例 如 Web 服务 描述 语言 WSDL(Web Services Description Language) 和 通用 描述 、 发 
现 和 集成 UDDI(Universal Description, Discovery, and Integration) 等 。 

总 体 来 说 ，SOAP 通常 具有 以 下 优点 。 

@ ”SOAP 消息 可 以 在 不 同 的 传输 协议 上 进行 传输 。 

SOAP 消息 通常 使 用 标准 的 HTTP 协议 作为 传输 协议 。 
SOAP 采用 易于 解析 的 XML。 

SOAP 有 很 强 的 可 扩展 性 。 

SOAP 实现 了 RPC 机 制 。 

SOAP 被 众多 主流 的 厂商 支持 。 

SOAP 被 众多 相关 的 标准 广泛 支持 。 


< 


6.1.2 SOAP 的 数据 格式 


SOAP 提供 了 一 个 传递 数据 的 机 制 ， 通 过 这 个 机 制 ， 特 定 于 应 用 程序 的 信息 能 够 以 一 种 可 
靠 的 方式 传送 。 同 时 ，SOAP 还 描述 了 SOAP 处 理 器 如 何 对 所 接收 的 SOAP 消息 进行 操作 。 

SOAP 消息 完全 基于 XML， 它 主要 包含 以 下 部 分 。 

@ ”Envelope 元 素 (封套 ): Envelope 元 素 是 表示 SOAP 消息 的 顶级 元 素 ， 它 是 必需 的 。 该 
元 素 包含 两 个 子 元 素 : Header 和 Body。 这 两 个 子 元 素 中 的 内 容 是 由 应 用 程序 定义 的 ， 
但 这 些 内容 并 不 属于 SOAP 规范 。 

@ Header 元 素 ( 报 头 ): SOAP 消息 的 报头 是 可 选 的 ， 它 是 一 种 用 来 向 SOAP 消息 添加 额 
外 特征 说 明 的 通用 机 制 。 通 过 这 种 机 制 ， 添 加 额外 的 特性 时 不 需要 得 到 通信 双方 的 事 
先 协商 。 也 正 是 因为 有 这 种 机 制 , 应 用 程序 才能 以 特定 的 方式 对 SOAP 消息 进行 扩充 。 
报头 可 以 包含 多 条 子 元 素 ， 我 们 可 以 称 之 为 报头 条 目 (Header block)， 它 们 可 以 表示 一 
些 逻 辑 数据 分 组 ， 可 被 传输 路 径 中 的 SOAP 节点 处 理 。 

@ ”Body 元 素 ( 报 体 ): Body 元 素 中 包含 发 送 给 信息 接收 方 的 信息 ， 它 是 必需 的 。SOAP 
消息 接收 者 最 终 的 目的 是 接收 并 处 理 Body 元 素 中 的 信息 。 

SOAP 消息 的 结构 如 图 6-3 所 示 。 


6-3 ”SOAP 消息 的 结构 


6.1.3 SOAP 封套 


封套 是 代表 SOAP 消息 的 XML 文档 的 最 顶层 元 素 ( 根 元 素 )。 在 封套 下 面 是 可 选 的 报头 元 
素 (Header 元 素 ) 和 必需 的 主体 元 素 (Body 元 素 )。 

在 SOAP 标准 的 XML 文档 中 使 用 Envelope 元 素来 封装 信息 。 一 个 Envelope 元 素 用 来 封装 
一 个 SOAP 消息 ， 也 就 是 说 SOAP 消息 中 的 所 有 内 容 都 必须 放 在 Envelope 元 素 中 。 

下 面 是 互联 网 中 某 个 Web Service 提供 商 提 供 的 具有 天 气 预报 功能 的 Web 服务 的 SOAP 消 
息 格 式 ， 代 码 如 下 : 


<?xm] Version="1.0"” encoding="utf-8"?> 


m= >> 
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<soap:Envelope xmlns:Xsi="http://www-w3-org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.o0rg/2001/xXMLSchema" 
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> 
<soap:Body> 
<GetWeather xmlns="http://www.webserviceX.NET"> 
<CityName>string</CityName> 
<CountryName>string</CountryName> 
</GetWeather> 
</soap:Body> 
</soap:Envelope> 
Envelope 元 素 是 一 个 XML 文档 元 素 , 所 以 可 以 在 该 元 素 中 做 其 他 元 素 可 以 做 的 任何 事情 ， 
比如 声明 一 些 命名 空间 等 。 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 是 每 个 SOAP 
消息 中 的 Envelope 元 素 都 必须 指定 的 命名 空间 。 对 于 SOAP 消息 来 说 ， 这 个 命名 空间 的 指定 
有 版 本 控制 的 作用 ， 所 以 在 SOAP 中 没有 定义 控制 版 本 的 声明 。 
”如 果 某 个 SOAP 消息 中 的 Envelope 元 素 与 其 他 命名 空间 相关 联 ， 处 理 这 个 消息 的 
提示 」 ”应 用 程序 就 会 报告 SOAP 版 本 错误 。 如 果 这 个 消息 是 通过 “请 求 /响应 ”得 到 的 ， 
应 用 程序 还 必须 返回 一 个 SOAP 错误 信息 。 


6.1.4 SOAP 报头 


SOAP 允许 用 户 在 封套 的 顶部 放置 一 个 有 效 负载 的 报头 。 该 报头 可 以 提供 一 些 详 细 的 信息 ， 
用 来 描述 SOAP 主体 传递 的 有 效 负载 。 
SOAP 的 报头 元 素 是 可 选 的 元 素 ， 可 以 定义 允许 在 报头 中 放置 不 限 数目 的 子 元 素 。 每 一 个 
子 元 素 代表 Microsoft 的 一 个 SoapHeader 类 的 实例 。 
， 在 SOAP 规 范 中 ，SOAP 的 报头 称 为 Header 元 素 ， 而 Microsoft 中 的 SoapHeader 
提示 类 把 SOAP 报头 看 成 是 Header 元 素 的 子 元 素 。 


报头 元 素 主要 用 来 传递 辅助 性 的 附加 消息 ， 比 如 身份 认证 、 会 话 ID 或 事务 ID 等 信息 。 所 
以 , 我 们 可 以 使 用 SOAP 的 报头 元 素来 扩展 SOAP 消息 传递 的 内 容 。 这些 报 头 元 素 通 常 有 助 于 
消息 接收 者 正确 处 理 接收 到 的 消息 内 容 。 


， 报头 元 素 在 SOAP 封套 的 内 部 是 一 个 可 选 元 素 。 但 是 它 如 果 出 现 ， 就 必须 是 
注意 | Envelope 元 素 的 第 一 个 直接 子 元 素 。 


报头 中 的 内 容 通常 是 各 应 用 程序 自己 定义 的 ， 也 就 是 说 不 同 的 应 用 程序 具有 不 同 的 内 容 。 

SOAP 规范 允许 使 用 应 用 于 报头 元 素 的 两 个 专用 的 属性 进一步 配置 报头 信息 ， 这 两 个 属性 
分 别 是 actor 和 mustUnderstand 。 

actor 属性 用 于 指定 报头 的 端点 类 型 。 端 点 类 型 并 不 是 应 用 于 Web 服务 ， 因 为 端点 一 般 来 
说 就 是 被 指向 的 Web 服务 。 指 定 端点 类 型 是 为 了 处 理 SOAP 消息 通过 中 间 设 备 传送 到 其 目的 
地 的 情况 。 这 里 的 中 间 设 备 可 能 是 网 络 中 的 一 个 网 关 ， 或 其 他 设备 。 

mustUnderstand 属性 可 以 用 来 标识 报头 是 否 必 须 被 处 理 (不 过 它 并 不 只 有 这 一 个 用 途 )。 比 
如 我 们 将 mustUnderstand 属性 的 值 设 为 1( 或 者 true)， 那 么 处 理 这 个 SOAP 消息 的 应 用 程序 就 
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必须 对 这 个 报头 进行 处 理 ， 或 者 生成 一 个 SOAP 错误 信息 。 

另外 ,还 需要 注意 一 件 事情 ，SOAP 报头 必需 属于 一 个 命名 空间 。 如 果 是 在 Web 服务 中 使 
用 SOAP， 则 很 简单 ， 我 们 可 以 直接 从 Web 服务 使 用 的 那个 命名 空间 获取 报头 。 

比如 要 为 前 面 使 用 的 那个 Web 服务 的 报头 指定 一 个 Language 属性 , 可 以 设置 该 Web 服务 
使 用 的 SOAP 报头 ， 如 下 所 示 : 

<?xml version="1.0" encoding="utf-8"?> 

<soap:Envelope xmlns:xsi="http://www.w3.0rg/2001/xMLSchema-instance" 

xmlns:xsd="http://www.w3.0rg/2001/XMLSchema" 

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> 
<soap:Header> 
<LanguageHeader soap:mustUnderstand="1"” xmlns="http://namespace"> 
<Language>zh_cn</Language> 
</LanguageHeader> 
</soap:Header> 
<soap:Body> 
«l== Body Content ==>» 
</soap:Body> 

</soap:Envelope> 

其 实 有 时 候 我 们 会 觉得 ， 如 果 使 用 消息 内 容 来 传递 这 些 信 息 会 更 加 方便 。 但 是 通过 使 用 
SOAP 报头 来 设置 或 获取 这 些 信息 会 更 好 一 点 。 

在 .NET Framework 中 ， 人 允许 在 代理 被 初始 化 的 时 候 指 定 报头 信息 ， 以 便 随后 的 所 有 Web 
服务 操作 都 能 够 使 用 它 。 这 也 可 以 简化 对 操作 的 调用 。 这 个 技术 通常 用 于 调用 Web 服务 要 求 
身份 验证 的 情况 ， 比 如 一 个 身份 验证 的 Key 可 以 放 在 一 个 报头 中 用 于 该 代理 所 执行 的 请 求 , 直 
到 Key 过 期 ， 或 者 用 户 退 出 ， 或 者 用 户 放弃 该 代理 对 象 。 

总 之 ， 如 果 保 存 一 些 与 内 容 不 相关 的 信息 时 ， 使 用 报头 将 非 党 有用， 例如， 保存 语言 和 身 
份 认证 等 环境 信息 。 


6.1.5 SOAP 主体 


SOAP 主体 是 一 组 SOAP 消息 所 必须 的 部 分 ， 一 个 SOAP 消息 可 以 没有 报头 ， 但 是 绝对 不 
能 没有 主体 。 

SOAP 的 主体 同样 使 用 XML 表示 ， 封 装 的 是 SOAP 消息 的 具体 内 容 。 

SOAP 1.2 版 本 的 标准 对 SOAP 的 主体 定义 了 如 下 规范 。 

@ 元 素 名 称 必 须 为 Body, 命名 空间 的 名 称 为 “http://www.w3.org/2003/05/soap-envelope”。 

@ 可 以 包含 零 个 或 多 个 XML 元 素 作为 主体 元 素 的 子 元 素 。 

@ 可 以 包含 零 个 或 多 个 XML 属性 作为 主体 元 素 的 属性 。 

对 于 SOAP 主体 的 子 元 素 的 要 求 ，SOAP 1.2 版 本 的 标准 做 了 如 下 规定 。 

@ ”应 该 包含 一 个 命名 空间 ， 以 防止 命名 冲突 。 

@ ”可 以 包含 任意 的 字符 信息 项 目 。 

@ 可 以 包含 任意 的 XML 元 素 。 

@ 包含 的 每 个 XML 元 素 都 可 以 具有 各 自 的 命名 空间 。 
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®@ ”可 以 包含 任 意 的 XML 地 址 。 
例 ” 标准 建议 SOAP 主体 的 子 元 素 应 该 包含 一 个 命名 空间 ， 但 这 只 是 为 了 防止 命名 冲 
提示 |」 ” 突 ， 所 以 并 不 是 每 个 子 元 素 都 必须 包含 命名 空间 。 


下 面 这 段 代 码 就 是 一 段 符合 SOAP 1.2 标准 的 SOAP 消息 。 该 消息 并 不 包含 SOAP 报头 ， 
只 有 一 个 SOAP 消息 主体 。 包 含 在 SOAP 主体 中 的 GetWeather 元 素 是 整个 SOAP 消息 的 有 效 
负载 ， 并 且 其 具有 一 个 命名 空间 “xmlns="http:/www.webserviceX.NET"”， 如 下 所 示 : 


<?xml] Version="1.0"” encoding="utf-8"?> 
<soapl2:Envelope xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema" 
xmlns:soapl2="http://www.w3.o0rg/2003/05/soap-envelope"> 
<soapl2:Body> 
<GetWeather xmlns="http://www.webserviceXx.NET"> 
<CityName>string</CityName> 
<CountryName>string</CountryName> 
</GetWeather> 
</soapl2:Body> 
</soapl2:Envelope> 


6.1.6 ”编码 数据 类 型 


SOAP 编码 使 用 的 是 一 个 简单 的 类 型 系统 。 一 个 数据 的 类 型 可 以 是 一 个 简单 的 基本 类 型 ( 比 
如 字符 串 、 数 值 和 布尔 等 )， 也 可 以 是 由 几 个 部 分 组 成 的 一 个 复合 数据 类 型 (比如 对 象 )。 在 这 个 
复合 类 型 中 ， 其 中 的 每 个 部 分 都 有 一 个 自己 的 类 型 ， 比 如 一 个 人 物 信息 的 姓名 、 年 龄 等 。 

因为 SOAP 消息 需要 以 文本 的 形式 将 所 有 数据 序列 化 到 XML 中 ， 所 以 如 果 某 种 数据 类 型 
可 以 使 用 XML Schema 表示 ， 它 就 可 以 序列 化 或 者 编码 为 SOAP 消息 。 

在 SOAP 中 ,有 两 种 主要 的 数据 类 型 可 以 轻松 地 编码 到 SOAP 消息 中 ,它们 是 简单 数据 类 
型 和 复合 数据 类 型 。 简 单数 据 类 型 是 在 XSD 规范 中 定义 为 内 置 类 型 的 数据 类 型 。 复 合 类 型 定 
义 为 对 其 他 值 的 关系 的 聚合 。 也 就 是 说 ， 复 合 类 型 是 以 某 种 形式 包含 的 一 组 相关 却 不 相同 的 简 
单数 据 类 型 ， 比 如 数组 、 结 构 或 对 象 。 

下 面 我 们 来 分 别 介 绍 这 些 数据 类 型 。 


1. 简单 数据 类 型 


在 SOAP 规范 中 默认 已 经 集成 了 许多 内 置 的 数据 类 型 , 这 些 数 据 类 型 和 大 多 数 编程 语言 中 
的 基本 数据 类 型 相对 应 ， 如 表 6-1 所 示 。 


表 6-1 SOAP 中 的 内 置 数据 类 型 


数据 类 型 描 述 


String | 表示 简单 的 字符 串 

Boolean | 表示 布尔 类 型 的 数值 ，true 或 false 
Pei 任意 精度 的 十 进 制 数据 

Float 单 精度 的 32 位 浮 点 数 
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续 表 
双 精 度 的 64 位 浮 点 数 
Duration 表示 一 段 时 间 
DateTime | 表示 特定 时 刻 
Time | 表示 每 天 中 的 特定 时 刻 
Date 表示 一 个 日 历时 间 


在 SOAP 中 ， 我 们 可 以 直接 使 用 XML 架构 规范 中 声明 的 数据 类 型 ， 也 可 以 使 用 从 这 些 类 
型 派生 的 新 类 型 。 例 如 ， 下 面 给 出 了 关于 前 面 SOAP 主体 结构 的 简单 类 型 的 架构 声明 : 

<wsdl:message name="GetWeatherHttpGetIn"> 

<wsdl:part name="CityName" type="s:string" /> 

<wsdl:part name="CountryName" type="s:string" /> 

</wsdl:message> 


2. 复合 数据 类 型 

复合 数据 类 型 其 实 是 一 组 具有 某 种 关系 的 简单 的 数据 类 型 的 集合 。SOAP 中 定义 了 两 个 复 
合 数据 类 型 : 结构 (StucD 和 数组 (Array)。 在 结构 中 ， 访 问 器 只 能 通过 成 员 的 值 来 区 分 ， 并 且 他 
们 的 名 称 不 能 相同 。 在 数组 中 ， 只 能 使 用 成 员 的 位 置 (索引 ) 来 区 分 成 员 的 值 。 


1) ”结构 
复合 值 的 成 员 编码 为 访问 器 元 素 。 当 访问 器 通过 名 称 来 区 分 时 ， 访 问 器 的 名 称 可 以 当做 元 
素 的 名 称 来 使 用 。 


例如 前 面 讲 过 的 一 个 SOAP 消息 的 主体 中 就 有 一 个 名 为 GetWeather 的 结构 代码 ， 如 下 
所 示 : 

<GetWeather xmlns="http://www.webserviceXx.NET"> 

<CityName>string</CityName> 


<CountryName>string</CountryName> 
</GetWeather> 


描述 上 面 这 段 代码 的 架构 代码 我 们 也 在 前 面 了 解 过 ， 如 下 所 示 : 


<wsdl:message name="GetWeatherHttpGetIn"> 
<wsdl:part name="CityName" type="s:string" /> 
<wsdl:part name="CountryName" type="s:string" /> 
</wsdl:message> 


2) 数组 

在 数组 中 ， 元 素 可 以 是 任意 的 一 组 数据 。 因 为 其 中 的 数据 可 以 重复 ， 或 者 完全 相同 ， 所 以 
数组 中 的 元 素 名 不 能 作为 唯一 标识 区 分 数组 中 的 数据 。 

例如 下 面 的 架构 实例 中 将 包含 一 组 整 型 的 数据 信息 ， 如 下 所 示 

<userAge xmlns:XSs="http://www-w3-org/2001/XMLSchema" 

xmlns:enc="http://www-w3.-org/2001/12/soap-encoding" 

enc:arrayType="xs:int[2]"> 

<age>32</age> 
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<age>23</age> 
<age>24</age> 
<age>27</age> 
<age>41</age> 
</userAge> 


当然 ， 也 可 以 使 用 下 面 的 代码 来 描述 上 面 的 声明 : 


<xs:element name="userAge" type="enc:Array"/> 


6.2 SOAP 用 于 RPC 


SOAP 是 一 个 标准 的 信息 交换 工具 。 但 是 在 Web 服务 应 用 程序 中 , 主要 使 用 SOAP 来 进行 
RPC 调用 。 

Web 服务 中 的 RPC 相对 于 DCOM 或 CORBA 的 繁琐 规定 来 说 ， 使 用 SOAP， 开 发 者 只 需 
要 了 解 基本 的 XML 知识 就 可 以 实现 RPC 调用 。 

SOAP 协议 中 规定 了 如 何在 SOAP 消息 中 描述 远程 过 程 的 标准 。 


A 
上 ' 视频 教学 : 光盘 /videos/06/SOAP 用 于 RPC avi 加 长 度 : 12 分钟 


在 SOAP 中 ,可 以 很 轻松 地 描述 远程 过 程 的 信息 ， 也 可 以 很 轻松 地 返回 远程 方法 的 执行 结 
果 。 所 以 在 Web 服务 中 使 用 SOAP 来 实现 RPC 调用 是 一 个 非常 简单 的 方法 。 


6.2.1 SOAP 的 RPC 规定 


因为 SOAP 非常 适合 于 RPC 调用 ,所 以 SOAP 协议 特别 为 Web 服务 中 的 远程 调用 功能 规 
定 了 SOAP 消息 封装 的 格式 。 其 中 包括 如 何在 SOAP 消息 中 序列 化 远程 过 程 的 方法 和 参数 ， 以 
及 过 程 的 返回 结果 等 。 

RPC 使 用 “请 求 /响应 ”的 模式 与 服务 器 交换 信息 ， 这 一 点 和 HTTP 非常 相似 。 使 用 SOAP 
调用 远程 方法 的 主要 工作 是 构造 SOAP 消息 : SOAP 请 求 消息 和 SOAP 响应 消息 。SOAP 请 求 
消息 封装 方法 的 调用 ， 并 发 送 给 远程 计算 机 ;SOAP 响应 封装 方法 的 调用 结果 ， 返 回 给 方法 的 
调用 者 。 

下 面 来 了 解 一 下 这 两 种 封装 消息 的 规则 。 

(1) RPC 请 求 消息 。 

使 用 SOAP 封装 RPC 调用 需要 首先 在 客户 端 构造 RPC 请 求 消息 ， 然 后 把 该 消息 发 送 给 代 
表 远 程 方法 的 服务 器 。SOAP 协议 规定 ， 在 远程 调用 的 SOAP 请 求 消 息 中 ， 使 用 一 个 “结构 ” 
来 代表 方法 调用 。 其 中 结构 中 的 成 员 代表 方法 的 参数 ， 结 构 的 名 称 必须 和 方法 的 名 称 相同 ， 而 
且 结构 中 成 员 的 名 称 必须 和 方法 的 参数 的 名 称 相同 。 

比如 上 一 节 使 用 的 一 个 例子 : 


<GetWeather xmlns="http://www.webservicex.NET"> 


<CityName>string</CityName> 


< 


<CountryName>string</CountryName> 
</GetWeather> 
上 述 代 码 表 示 “http://www.webserviceX.NET ”命名 空间 中 的 Web 服务 中 有 一 个 GetWeather 
方法 ， 该 方法 有 两 个 参数 ， 分 别 是 CityName 和 CountryName。 所 以 这 个 方法 在 服务 器 端的 声 
明 应 该 如 下 所 示 : 
// 根 据 城市 名 称 和 国家 名 称 获取 天 气 预 报信 息 
public string GetWeather (string CityName, string CountryName) 
使 用 GetWeather 方法 执行 远程 方法 调用 操作 时 ， 如 果 要 查询 中 国 (China) 郑 州 (zhengzhou) 
的 天 气 预报 信息 ，Body 元 素 中 的 内 容 应 该 如 下 所 示 : 
<GetWeather xmlns="http://www.webserviceXx.NET"> 
<CityName>zhengzhou</CityName> 


<CountryName>China</CountryName> 
</GetWeather> 


在 这 里 , 远程 方法 调用 的 描述 信息 使 用 结构 表示 。 当 序列 化 为 XML 文档 以 后 , 它 就 是 Body 
元 素 中 的 具体 内 容 (GetWeather 子 元 素 )。 同 样 ， 该 方法 的 参数 使 用 结构 中 的 成 员 表 示 ， 序 列 化 
以 后 ， 它 们 就 是 方法 元 素 中 的 子 元 素 。 

(2) RPC 响应 消息 。 

前 面 我 们 说 过 ，SOAP 协议 规定 了 RPC 调用 使 用 的 请 求 和 响应 的 封装 格式 ， 调 用 包含 在 
SOAP 请 求 消息 中 ,而 执行 结果 包含 在 SOAP 响应 消息 中 。 在 RPC 响应 消息 中 ,也 是 使 用 结构 
来 表示 方法 的 执行 结果 ， 结 构 的 成 员 格式 化 了 输出 参数 或 方法 的 返回 值 。 

SOAP 协议 规定 ， 表 示 方 法 执行 结果 的 结构 名 称 是 在 方法 的 名 称 之 后 加 Response 关键 字 。 
例如 ,如 果 方 法 名 为 GetWeather, 那么 方法 的 执行 结果 应 该 使 用 名 为 GetWeatherResponse 的 结 
构 表 示 。 另 外 ， 和 调用 方法 一 样 ， 执 行 结果 中 代表 输出 参数 的 结构 成 员 名 称 必需 和 方法 的 声明 
中 对 应 的 参数 名 称 相同 。 如 果 方 法 有 返回 值 ， 则 返回 值 的 名 称 可 以 是 任意 值 ， 但 必须 是 结构 的 
第 一 个 成 员 。 

这 里 还 以 前 面 介 绍 过 的 GetWeather 方法 为 例 ， 声 明代 码 如 下 : 

// 根 据 城市 名 称 和 国家 名 称 获取 天 气 预 报信 息 


public string GetWeather (string CityName, string CountryName) 


使 用 远程 方法 调用 GetWeather 后 ，SOAP 封装 的 Body 元 素 内 容 如 下 所 示 : 


<GetWeatherResponse xmlns="http://www.webserviceXx.NET"> 
<GetWeatherResult>string</GetWeatherResult> 
</GetWeatherResponse> 


6.2.2 RPC 和 HTTP 


刚才 我 们 研究 了 如 何 格式 化 RPC 请 求 和 响应 的 SOAP 消息 。 但 是 如 果真 的 要 执行 RPC 调 
用 ,还 必需 用 某 种 方式 发 送 这 些 消息 , 也 就 是 要 使 用 某 个 传输 方法 。 如 果 我 们 能 把 RPC 和 HTTP 
联合 起 来 使 用 ， 那 也 许 才 是 SOAP 协议 在 Web 服务 中 价值 的 最 好 体现 。 


Eee 人 >> 
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比如 我 们 知道 有 一 个 查询 人 P 地 址 的 Web 服务 ， 它 可 以 使 用 “http://www.webservicex.net/ 
geoipservice.asmx?WSDL” 来 调用 。 该 Web 服务 有 一 个 GetGeolP 方法 ， 声 明 如 下 : 


// 查 询 IP 归属 地 


public string GetGeoIP (string IPAddress) 


该 方法 可 以 根据 他 地 址 查询 出 该 他 地 址 对 应 的 地 理 位 置 。 

当 我 们 使 用 HTTP SOAP 消息 请 求 这 个 方法 时 ， 首 先 需 要 用 一 个 结构 来 封装 该 方法 ， 方 法 
的 参数 用 子 元 素 表示 。 

下 面 是 调用 该 方法 的 HTTP 请 求 ， 其 中 包括 SOAP 消息 的 内 容 ， 代 码 如 下 : 


POST /geoipservice.asmx HTTP/1.1 
Host: www.webservicex.net 
Content-Type: text/xml; charset=utf-8 
Content-Length: ### 
SOAPAction: "http://www.webservicex.net/GetGeoIPp" 
<?xml version="1.0" encoding="utf-8"?> 
<soap:Envelope xmlns:Xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0org/2001/XMLSchema" 
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> 
<soap:Body> 
<GetGeoIP xmlns="http://www.webservicex.net/"> 
<IPAddress>202.102.224.68</IPAddress> 
</GetGeoIP> 
</soap:Body> 
</soap:Envelope> 


如 果 使 用 上 述 SOAP 消息 调用 远程 Web 服务 ， 在 返回 的 SOAP 消息 中 可 以 看 到 包含 RPC 
的 结果 ， 如 下 所 示 : 


HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: ### 
<?xml Version="1.0" encoding="utf-8"?> 
<soap:Envelope xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0org/2001/XMLSchema" 
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> 
<soap:Body> 
<GetGeoIPResponse xmlns="http://www.webservicex.net/"> 
<GetGeoIPResult> 
<?xml version="1.0" encoding="utf-8" ?> 
<GeoIP xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.o0rg/2001/XMLSchema™" 
xmlns="http://www.webservicex.net/"> 
<ReturnCode>1</ReturnCode> 
<IP>202.102.224.68</IP> 
<ReturnCodeDetails>Success</ReturnCodeDetails> 
<CountryName>China</CountryName> 
<CountryCode>CHN</CountryCode> 
</GeoIP> 
</GetGeoIPResult> 
</GetGeoIPResponse> 
</soap:Body> 
</soap:Envelope> 


< 


6.3 ”使 用 Web 服务 上 传 和 下 载 图 片 


只 要 能 被 XML 序列 化 的 数据 都 能 通过 SOAP 消息 进行 传递 (比如 一 些 简单 的 数据 类 型 , 或 
者 数组 、 简 单 的 对 象 等 )。 但 是 我 们 如 果 要 传递 一 些 结构 比较 复杂 的 数据 类 型 (比如 数据 集 
DataSet、 二 进 制 数据 流 )， 又 该 怎么 办 呢 ? 

其 实 NET Framework 中 的 XML 序列 化 机 制 同样 可 以 序列 化 这 些 特殊 的 数据 类 型 ， 以 便 让 
它们 能 够 在 SOAP 消息 中 进行 传递 。 这 样 做 的 好 处 有 很 多 ， 比 如 我 们 可 以 从 Web 服务 中 获取 
一 个 数据 集 ， 使 我 们 可 以 很 方便 地 在 客户 端 进行 读 取 数 据 的 操作 ， 或 者 通过 传递 二 进 制 数据 来 
使 Web 服务 能 够 传输 图 像 、 动 画 等 非 文本 格式 的 文件 。 


ca 视频 教学 : 光盘 /videos/06/ 上 传 和 下 载 图 片 .avi @ 长 度 : 18 分 钟 


6.3.1 基础 知识 一 一 传递 特殊 的 数据 类 型 


因为 Web 服务 的 特殊 性 ,所 以 在 Web 服务 中 的 远程 方法 调用 不 可 能 像 本 地 方法 一 样 方便 。 
所 以 我 们 需要 对 程序 中 的 一 些 特殊 的 数据 进行 一 些 特殊 的 处 理 。 


1. 传送 数据 集 DataSet 


数据 集 DataSet 是 .NET Framework 中 的 ADONET 模块 的 一 部 分 。 数 据 集 可 以 认为 是 无 连 
接 的 数据 库 , 它 包含 一 组 与 数据 库 中 的 表 十 分 类 似 的 表 。 另外 它 还 包含 一 些 表 及 表 之 间 的 关系 。 
因此 ， 完 全 可 以 认为 它 是 一 个 内 存 中 的 微型 数据 库 。 

可 以 把 数据 集中 的 数据 看 成 是 关系 化 了 的 数据 。 在 使 用 序列 化 机 制 转换 数据 集 的 时 候 ， 数 
据 集中 的 数据 将 以 XML 表示 。 


\ 尽管 数据 集 在 功能 上 和 数据 库 表 十 分 类 似 ， 而 且 一 般 来 说 数据 集 都 是 使 用 数据 库 
得 示 | 。 表 中 的 记录 进行 填充 ， 但 是 数据 集 和 数据 库 表 之 间 是 没有 实际 关系 的 。 

数据 集 的 功能 非常 强大 ， 可 以 把 它 绑 定 到 Windows 窗 体 中 的 网 格 控件 (DataGridView) 中 ， 
在 窗 体 中 做 的 任何 修改 ， 都 可 以 使 用 数据 集 进行 跟踪 ， 而 且 还 可 以 实现 在 数据 库 中 更 新 数据 集 
中 修改 的 内 容 。 

(1) 返回 数据 集 。 

在 Web 服务 中 使 用 数据 集 ， 和 在 单个 应 用 程序 中 使 用 数据 集 的 方式 并 不 相同 。 在 Web 服 
务 中 ， 需 要 在 服务 器 端 获取 数据 集 以 后 ， 把 数据 集 对 象 通过 SOAP 消息 发 送 到 客户 端 
由 于 数据 集 是 一 个 NET 对 象 , 可 以 直接 在 NET 内 被 序列 化 , 所 以 我 们 不 用 做 过 多 的 操作 
直接 在 Web 服务 方法 中 返回 数据 集 对 象 即 可 。 

(2) 使 用 数据 集 更 新 数据 库 。 

前 面 我 们 说 过 ， 数 据 集 还 可 以 跟踪 修改 ， 而 且 可 以 使 用 数据 集 来 更 新 数据 库 中 的 数据 ， 所 
以 还 可 以 把 客户 端 操作 过 的 数据 集 对 象 发 送 到 服务 器 中 ， 使 用 数据 集 对 数据 库 进行 修改 操作 。 
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也 就 是 说 , 我 们 可 以 在 Web 服务 方法 中 声明 一 个 Dataset 参数 ,接收 从 客户 端 提交 过 来 的 数据 
集 对 象 ， 使 用 该 数据 集 对 象 更 新 数据 库 。 
》。 在 使 用 数据 集 更 新 数据 库 时 需要 注意 : 客户 端 发 送 回来 的 数据 集中 带 有 从 数据 库 
过 | 。 中 检索 得 到 的 所 有 初始 数据 ， 以 及 客户 端 对 数据 集 的 修改 操作 ， 所 以 我 们 需要 
尽量 保持 数据 集中 最 必要 的 数据 ， 否 则 会 大 大 增加 网 络 传输 的 数据 量 ， 降 低 程序 
效率 。 
2， 二进制 数据 
在 网 络 中 ， 文 件 的 传递 一 直 是 非常 让 开发 人 员 头疼 的 问题 。 如 果 Web 服务 中 允许 在 客户 
端 和 服务 器 端 之 间 双 向 地 传递 二 进 制 数据 ， 那 么 就 可 以 很 方便 地 实现 文件 的 传递 。 但 是 Web 
服务 中 使 用 XML 文本 的 形式 封装 消息 ， 所 以 无 法 在 Web 服务 中 直接 传递 二 进 制 对 象 。 
因为 在 NET Framework 中 ， 可 以 使 用 内 存 流 (Memory Stream) 读 取 文 件 并 将 其 转换 为 字 节 
数组 ， 所 以 可 以 把 文件 以 字 节 数组 的 方式 在 网 络 中 传递 
我 们 知道 在 Web 服务 中 传递 一 个 二 进 制 数组 是 非常 容易 的 事情 。 
当然 ， 在 Web 服务 的 客户 端 ， 接 收 到 二 进 制 数组 以 后 ， 使 用 内 存 流 进行 加 工 ， 就 可 以 还 
原 服务 器 发 送 回来 的 文件 。 


6.3.2 ”实例 描述 


使 用 Web 服务 在 网 络 中 传输 文件 是 非常 慨 意 的 事情 。 我 们 可 以 将 二 进 制 的 文件 转换 为 可 
以 被 XML 序列 化 的 字 节 数组 ， 然 后 分 别 在 客户 端 和 服务 器 端 操 作 这 个 字 节 数组 。 

本 实例 ， 我 们 就 使 用 Web 服务 来 实现 一 个 上 传 和 下 载 图 片 的 功能 。 需 要 首先 在 Windows 
窗 体 应 用 程序 的 客户 端 选择 一 个 图 片 文件 ， 并 上 传 到 服务 器 。 然 后 在 客户 端 将 刚才 上 传 的 这 个 
图 片 文件 下 载 下 来 ， 显 示 到 窗 体 中 。 


6.3.3 ”实例 应 用 


【 例 6-1】 使 用 Web 服务 上 传 和 下 载 图 片 
(1) 在 Web 服务 器 端 创建 一 个 Web 服务， 命名 为 WSUpload。 
(2) 在 WSUpload 中 添加 一 个 上 传 文件 的 Web 方法 , 命名 为 UploadFile。 该 方法 接收 一 个 
字 节 数组 和 一 个 文件 名 称 ， 使 用 文件 流 将 字 节 数组 保存 到 磁盘 中 的 指定 文件 中 ， 代 码 如 下 : 


[WebMethod] 
public void UploadFile(byte[] content, string fileName) 


{ 


fileName = "D:\\" + fileName; 


// 创 建 一 个 文件 流 对 象 ， 并 初始 化 


FileStream fs = new FilesStream(fileName, FileMode.OpenOrCreate); 


< 全 


// 向 文件 流 中 写 入 内 容 


fs.Write(content, 0, content.Length); 


// 关 闭 流 


fs.Close(); 
} 
(3) 在 WSUpload 中 添加 一 个 下 载 文件 的 Web 方法 ， 命 名 为 GetFile。 该 方法 接收 一 个 文 
件 名 ， 实 现 把 磁盘 中 的 指定 文件 序列 化 成 一 个 字 节 数组 ， 并 发 送 到 客户 端 ， 代 码 如 下 : 
[WebMethod] 


public byte[] GetFile(string fileName) 
{ 


fileName = "D:\\" + fileName; 


// 创 建 一 个 文件 流 对 象 ， 并 初始 化 


FileStream fs = new Filestream(fileName, FileMode.Open); 


// 创 建 一 个 二 进 制 数组 
byte[] bs = new byte[fs.Length]7 


// 从 文件 流 中 读 取 内 容 
fs.Read(bs, 0, bs.Length); 


// 关 闭 流 


fs.close(); 


// 以 二 进 制 数 组 的 形式 返回 文件 内 容 

return bs; 
| 
(4) 在 客户 端 Windows 应 用 程序 中 添加 对 Web 服务 WSUpload 的 服务 引用 。 
(5) 创建 一 个 用 于 上 传 和 下 载 图 片 文件 的 窗 体 ， 设 计 界 面 如 图 6-4 所 示 。 


宣 虹 并 上 次 文件 


6-4 【上 传 图 片 】 窗 口 设计 界面 
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(6) 在 【浏览 并 上 传 文件 】 按 钮 的 单 击 事件 中 使 用 一 个 打开 文件 对 话 框 (OpenFileDialog) 
浏览 本 地 磁盘 中 的 一 个 文件 ， 并 将 其 序列 化 为 一 个 字符 数组 。 然 后 创建 一 个 上 传 文件 的 Web 
服务 的 代理 对 象 ， 实 现 上 传 文件 。 代 码 如 下 : 


private void btnSearch Click(object sender, EventArgs e) 


{ 


// 创 建 一 个 文件 浏览 对 话 框 ， 并 弹出 该 对 话 框 用 于 获取 一 个 本 地 磁盘 中 的 文件 名 称 
OpenFileDialog ofd = new OpenFileDialog(); 
ofd.showDialog(); 
string fileName = string.Empty, 
shortFileName = string.Empty; 
try 
| 
// 获 取 文件 浏览 对 话 框 选中 的 文件 名 称 
fileName = ofd.FileName; 
shortFileName = fileName.Substring (fileName.LastIndexOf ('\\') + 1); 
this.txtAllName.Text = fileName; 
this.txtFileName.Text = shortFileName; 
} 
catch 
{ 
// 如 果 在 获取 文件 名 称 的 过 程 中 出 现 异常 ， 捕 获 并 使 方法 返回 
return; 


} 


// 创 建 一 个 文件 流 对 象 ， 并 初始 化 

FileStream fs = new FileStream(fileName，FileMode.Open) 
// 创 建 一 个 二 进 制 数组 

byte[] bs = new bytel[lfs.Length]; 

// 从 文件 流 中 读 取 内 容 

fs.Read(bs, 0, bs.Length); 

// 关 闭 流 


fs.Close(); 


// 创 建 一 个 上 传 或 下 载 文件 的 web 服务 代理 类 对 象 


ServiceUpload.WSUploadSsoapClient upload = new 


ServiceUpload.WSUploadSoapClient (); 


} 


// 执 行 上 传 文件 操作 


upload.UploadFile(bs, shortFileName); 


MessageBox .Show(" 图 片上 传 成 功 ! "); 


(7) 在 【下 载 服务 器 端 文件 】 按 钮 的 单 击 事件 处 理 程序 中 添加 从 Web 服务 中 获取 文件 的 


代码 。 


这 需要 首先 从 Web 服务 器 端 获 取 指定 文件 的 字符 数组 ， 并 将 其 转换 为 位 图 对 象 ， 再 显示 
到 窗 体 中 的 PictureBox 对 象 中 ， 代 码 如 下 : 


< 一 


private void btnDownload Click(object sender, EventArgs e) 
{ 
// 获 取 文 件 名 称 
string shortFileName = this.txtFileName.Text; 
// 创 建 一 个 上 传 或 下 载 文件 的 web 服务 代理 类 对 象 
ServiceUpload.WSUploadSsoapClient upload = new 
ServiceUpload.WSUploadSsoapClient (); 
//upload. 
// 获 取 以 字 节 数组 保存 的 文件 内 容 
byte[] bs = upload.GetFile(shortFileName); 
// 创 建 一 个 内 存 流 对 象 ， 并 用 字 节 数组 初始 化 该 对 象 
MemoryStream ms = new MemoryStream(bs); 
// 创 建 一 个 位 图 对 象 ， 并 使 用 内 存 流 对 象 初始 化 该 位 图 对 象 
Bitmap b = new Bitmap (ms) 7 
// 将 该 位 图 对 象 显示 到 窗 体 中 
this.picImage.Image = b; 
// 关 闭 流 


ms.Close(); 


} 


@@ ” 在 使 用 Web 服务 执行 文件 的 上 传 或 下 载 操作 时 ,应 用 程序 可 能 会 因为 上 传 的 文件 
注意 | 。 过 大 而 抛 出 异常 。 因 此 需要 在 客户 端 和 服务 器 端的 配置 文件 中 设置 上 传 和 下 载 的 
文件 大 小 限制 。 


6.3.4 运行 结果 


首先 运行 Web 服务 项 目 ， 然 后 再 运行 客户 端的 Windows 窗 体 应 用 程序 “上 传 图 片 ”。 

在 “上 传 图 片 ” 窗 口中 ， 单 击 “ 浏 览 并 上 传 文件 ”按钮 ， 选 择 一 个 本 地 磁盘 中 的 图 片 文件 
(这 里 是 盘 中 的 apjpg 文件 )， 系 统 会 自动 上 传 该 文件 ， 在 窗 体 上 的 文本 框 中 显示 这 个 图 片 的 
文件 名 ， 并 且 弹 出 对 话 框 提示 用 户 上 传 成 功 ， 如 图 6-5 所 示 。 

然后 单 击 【上传 图 片 】 窗 口中 的 【下 载 服务 器 端 文件 】 按 钮 ， 系 统 会 获取 服务 器 端 文件 内 
容 并 显示 到 窗 体 中 的 图 片 框 中 ， 如 图 6-6 所 示 。 


并 上 传 六 件 下 过 服务 可 坟 文 件 


加 


图片 上 作成 2 
[| 


图 6-5 图 片上 传 成 功 图 6-6 图 片 下 载 成 功 
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6.3.5 ”实例 分 析 


Saami 


在 本 实例 中 ， 二 进 制 文件 和 字符 数组 之 间 的 转换 操作 执行 了 4 次 。 首先 在 Web 服务 中 编 
写 一 个 接收 上 传 文件 功能 的 Web 方法 ， 接 收 客户 端 传递 过 来 的 字符 数组 ， 使 用 文件 流 将 其 保 
存 到 磁盘 中 ; 然后 在 Web 服务 中 添加 一 个 接收 下 载 文件 功能 的 Web 方法 ， 接 收 客户 端 传递 的 
文件 名 称 ， 从 磁盘 中 读 取 该 文件 ， 并 转换 成 字符 数组 ， 返回 给 客户 端 ， 接 下 来 在 客户 端 执行 上 
传 文件 的 操作 时 ,使 用 文件 流 将 本 地 文件 转换 为 字符 数组 并 上 传 到 服务 器 。 在 执行 下 载 操作 时 
获取 服务 器 端 返回 的 字符 数组 ， 使 用 内 存 流 将 其 转换 为 位 图 图 像 ， 并 显示 到 窗 体 中 。 


6.4 隐藏 用 户 的 隐私 信息 


Web 服务 一 般 都 是 在 Internet 中 使 用 ， 然 而 Internet 中 的 各 种 使 用 Web 服务 的 平台 和 技术 
都 不 一 定 相同 。 因 此 ，ASP.NET 所 使 用 的 默认 的 SOAP 消息 格式 可 能 与 其 他 技术 的 实现 不 兼 
容 。 所 以 为 了 应 用 程序 的 兼容 性 ， 我 们 就 需要 对 Web 服务 使 用 的 SOAP 消息 格式 进行 定制 ， 
以 更 好 地 与 其 他 平台 上 的 应 用 程序 进行 通信 。 

在 ASPNET Web 服务 中 ，.NET Framework 提供 了 一 些 格式 化 SOAP 消息 格式 的 方法 , 我 
们 可 以 很 方便 地 在 代码 中 指定 SOAP 消息 的 格式 。 


FP? ) 
匡 w， 视频 教学 : 光盘 /videos/06/ 隐 藏 隐私 信息 .avi 长 度 : 23 分 钟 


6.4.1 基础 知识 一 一 定制 SOAP 消息 


SOAP 消息 一 般 具 有 两 种 编码 格式 : Document 格式 和 RPC 格式。 在 .NET Framework 中 对 
SOAP 消息 进行 编码 的 方法 也 有 两 种 : 使 用 属性 定制 XML 和 使 用 XML 序列 化 SOAP 消息 。 
下 面 来 分 析 SOAP 的 消息 编码 格式 ， 并 了 解 这 两 种 编码 SOAP 消息 的 方法 。 


1. 消息 的 编码 格式 


SOAP 消息 有 两 种 编码 格式 : Document 格式 和 RPC 格式 ， 我 们 可 以 用 这 两 种 编码 格式 来 
指定 如 何 对 整个 Body 元 素 进行 编码 。 

当 使 用 Document 样式 时 ， 系 统 将 基于 XML 架构 定义 来 格式 化 Body 元 素 中 的 内 容 ; 使 用 
RPC 格式 时 ， 将 会 把 所 有 的 参数 信息 放 到 一 个 单一 的 元 素 中 ， 然 后 再 把 这 个 元 素 放 到 Body 元 
素 中 。 在 使 用 RPC 格式 时 ， 这 个 单一 的 元 素 名 称 与 RPC 方法 的 名 称 相同 ， 其 中 的 子 元 素 对 应 
于 该 方法 的 参数 和 返回 值 。 

对 于 单独 参数 的 编码 ， 我 们 可 以 使 用 Literal 格式 或 Encoded 格式 。 在 Literal 格式 中 ， 每 
个 参数 都 直接 保存 在 一 个 与 之 对 应 的 元 素 中 ; 在 Encoded 格式 中 ,将 会 为 每 个 参数 定义 一 个 不 


< 


同 的 复杂 类 型 ， 然 后 把 参数 保存 在 这 个 复杂 类 型 的 元 素 中 。 

在 WSDL 规范 中 ，soap:body 扩充 性 元 素 包含 一 个 Use 属性 ， 这 个 属性 就 是 用 来 指定 单个 
参数 的 编码 格式 的 。 当 整个 SOAP 消息 使 用 Document 格式 进行 编码 时 ， 可 以 设置 单个 参数 的 
编码 格式 使 用 Literal 或 Encoded。 当 整个 SOAP 消息 使 用 RPC 格式 进行 编码 时 ， 还 可 以 将 单 
个 参数 使 用 Encoded 编码 格式 。 


2. 使 用 属性 定制 XML 


.NET Framework 中 提供 了 4 个 属性 用 于 设置 SOAP 消息 的 编码 格式 ， 分 别 是 : 
SoapDocumentMethodAttribute 、 SoapDocumentServiceAttribute 、 SoapRpcMethodAttribute 和 
SoapRpcServiceAttribute。 

其 中 SoapDocumentServiceAttribute 属性 和 SoapRpcServiceAttribute 属性 可 以 用 来 设置 整个 
Web 服务 类 的 默认 编码 格式 。 在 没有 专门 指定 编码 格式 的 方法 中 将 使 用 这 些 属 性 设置 的 编码 
格式 。 

剩 下 的 SoapDocumentMethodAttribute 属性 和 SoapRpcMethodAttribute 属性 可 以 用 来 设置 特 
定 方法 的 编码 格式 ， 这 些 属 性 设置 将 会 覆盖 默认 的 编码 样式 。 

1) ”SoapDocumentServiceAttribute 属性 

SoapDocumentServiceAttribute 属性 需要 在 Web 服务 的 实现 类 上 使 用 。 它 可 以 把 该 类 中 所 
有 Web 方法 的 SOAP 消息 编码 设置 为 Document。 如 下 所 示 : 

// 其 他 配置 省 略 

[SoapDocumentServiceAttribute] 

public class Default : System.Web.Services.WebService 

{ 

// 代 码 省 略 

在 使 用 SoapDocumentServiceAttribute 属性 时 , 还 可 以 通过 使 用 Use 属性 指定 参数 的 编码 
格式 。Use 属性 是 一 个 枚 举 类 型 SoapBindingUse 的 值 ， 它 有 三 个 可 选 值 ， 分 别 是 Default、 
Encoded 和 Literal。 关 于 这 三 个 可 选 值 的 说 明 如 表 6-2 所 示 。 


表 6-2 Use 属性 的 可 选 值 


Default | 为 相应 的 XML use 属性 指定 空 字符 串 ("") 值 
使 用 给 定 的 编码 规则 对 消息 部 分 进行 编码 


消息 部 分 表示 具体 架构 


Encoded 


Literal 


另外 ，SoapDocumentServiceAttribute 属性 中 还 有 一 个 ParameterStyle 属性 ， 它 用 来 指定 是 
直接 把 参数 放 到 Body 元 素 中 还 是 先 把 它 放 到 一 个 XML 元 素 中 ， 然 后 再 放 到 Body 元 素 中 。 
ParameterStyle 属性 是 一 个 枚 举 类 型 SoapParameterStyle 的 值 ， 它 也 有 三 个 可 选 的 值 ， 分 别 是 
Default、Bare 和 Wrapped。 关 于 这 三 个 可 选 值 的 说 明 如 表 6-3 所 示 。 


m= >> 
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表 6-3 ParameterStyle 属性 的 可 选 值 


值 说 明 


Default 


指定 使 用 Web 服务 的 默认 参数 格式 


Bare | 将 Web 服务 的 参数 放 在 SOAP 请 求 或 SOAP 响应 的 Body 元 素 之 后 


Wrapped 将 Web 服务 的 参数 封装 在 SOAP 请 求 或 SOAP 响应 的 单个 XML 元 素 中 。 


2) SoapRpcServiceAttribute 属性 
该 属性 用 来 将 整个 Web 服务 的 SOAP 消息 的 默认 编码 设置 为 RPC 格式 。 设 置 格式 如 下 


所 示 : 


// 其 他 配置 省 略 

[SoapRpcServiceAttribute] 

public class Default : System.Web.Services.WebService 
// 代 码 省 略 

} 

3) ”SoapDocumentMethodAttribute 属性 

该 属性 用 来 为 特定 的 方法 指定 Document 编码 格式 。 

SoapDocumentMethodAttribute 属性 类 包含 以 下 可 以 影响 SOAP 消息 格式 的 属性 。 

@ ”Action: 指定 SOAP 请 求 消息 中 的 SOAPAction 头 字 段 ， 其 默认 值 为 Web 服务 的 命名 
空间 加 上 方法 名 。 

e@ ”OneWay: 指定 客户 端 程序 是 否 等 待 Web 服务 完成 对 所 请 求 的 方法 的 处 理 。 如 果 这 个 
属性 设置 为 tue， 则 Web 服务 器 在 反 序 列 化 SOAP 消息 以 后 ， 调 用 被 请 求 方法 之 前 
就 会 向 客户 程序 返回 一 个 HTTP202 的 状态 码 ， 表 示 它 已 经 接受 这 个 请 求 。 但 是 在 这 
种 情况 下 , 客户 端 就 不 会 接收 到 带 返 回 结果 的 方法 调用 的 返回 值 , 而 是 一 个 HTTP 202 
的 响应 消息 。 如 果 该 属性 值 为 false( 默 认 值 ), 表示 客户 端 程序 必须 等 待 Web 服务 完成 
调用 方法 的 处 理 。 此 时 客户 端 会 接收 到 一 个 HITP 200 的 响应 消息 ， 表 示 执 行 成 功 ， 
并 且 同 时 会 得 到 方法 的 执行 结果 。 

@ 。 ParameterStyle: 指定 是 否 把 方法 的 参数 封装 到 Body 元 素 下 的 一 个 单一 元 素 中 。 该 
属性 的 取 值 与 效果 同 SoapDocumentServiceAttribute 属性 中 的 ParameterStyle 属性 完全 

@ 。 RequestElementName: 指定 SOAP 请 求 消息 中 与 该 方法 对 应 的 元 素 的 名 称 。 在 默认 情 
况 下 ， 这 个 元 素 的 名 称 与 方法 名 相同 。 

》$。 当 ParameterStyle 属性 的 值 为 Bare 时 , 方法 的 参数 直接 出 现在 Body 元 素 中 ,所 以 
注意 | 在 这 种 情况 下 ，RequestElementName 属性 的 值 不 起 作用 。 


< 


@ ”RequestNamespace: 指定 该 方法 对 应 的 SOAP 请 求 消息 的 命名 空间 ， 默 认 值 为 Web 
服务 的 命名 空间 。 
@ ResponseElementrName: 指定 SOAP 响应 消息 中 与 该 方法 对 应 的 元 素 的 名 称 。 默 认 情 
况 下 ， 方 法 对 应 的 元 素 的 名 称 为 方法 名 加 上 Response 后 组 。 
@ ”ResponseNamespace: 指定 SOAP 响应 消息 中 该 方法 所 属 的 命名 空间 。 默 认 情 况 下 ， 
命名 空间 为 Web 服务 的 命名 空间 。 
@ Use: 指定 方法 的 参数 在 Body 元 素 中 的 格式 化 方式 。 它 的 取 值 和 作用 同 
SoapDocumentServiceAttribute 属性 中 的 Use 属性 完全 相同 。 
4) ”SoapRpcMethodAttribute 属性 
该 属性 为 特定 的 方法 指定 RPC 编码 格式 。 
SoapRpcMethodAttribute 属性 除了 没有 Use 属性 和 ParameterStyle 属性 以 外 , 其 他 的 属性 与 
SoapDocumentMethodAttribute 属性 完全 相同 。 
由 于 在 RPC 格式 下 将 使 用 Message 元 素 和 portType 元 素来 格式 化 方法 对 应 的 元 素 ， 而 不 
是 使 用 types 元 素 中 定义 的 类 型 , 所 以 RequestElementName 属性 中 指定 的 值 将 不 会 对 SOAP 消 
息 产生 任何 影响 。 
3. 使 用 XML 序列 化 SOAP 消息 
序列 化 是 将 对 象 转 换 成 容易 存储 或 在 网 络 中 进行 传输 的 数据 的 过 程 。 反 序列 化 和 序列 化 刚 
好 相反 ， 是 将 序列 化 过 的 数据 重新 整理 并 构造 成 对 象 的 过 程 。 
使 用 XML 序列 化 就 是 将 对 象 转换 成 XML 流 .XML 序列 化 只 转换 对 象 的 公共 字段 和 属性 ， 
并 不 转换 方法 、 索 引 器 、 私 有 字段 和 只 读 属 性 。 
因为 SOAP 消息 就 是 使 用 XML 序列 化 生成 的 数据 ， 所 以 我 们 还 可 以 通过 控制 XML 序列 
化 的 操作 来 定制 最 终生 成 的 SOAP 消息 。 
对 XML 序列 化 过 程 的 控制 主要 通过 指定 属性 来 完成 。 
1) “使 用 属性 控制 XML 序列 化 
我 们 可 以 在 类 、 类 的 公有 字段 、 类 的 属性 、 方 法 的 参数 和 方法 的 返回 值 上 应 用 一 些 属 性 ， 
用 来 指定 它们 在 XML 文档 中 对 应 元 素 的 数据 类 型 、 名 称 和 命名 空间 等 信息 。 
例如 ， 有 一 个 名 为 Book 的 类 ， 其 中 有 两 个 公有 字段 Name 和 ISBN。 如 果 想 要 为 Name 字 
段 指定 一 个 不 同 的 元 素 名 称 ， 就 可 以 使 用 XmlElement 属性 为 类 或 成 员 指定 一 个 别名 
BookName， 如 下 所 示 : 


public class Book 

{ 
[XmlElement (ElementName = "BookName")] 
public string Name; 
public string ISBN; 

和 


这 样 在 使 用 XML 序列 化 时 ， 公 有 字段 Name 对 应 的 元 素 名 称 就 该 是 BookName， 而 不 是 
Name 了 。 
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类 XML 在 System.Xml.Serialization 命名 空间 中 声明 ， 所 以 在 使 用 XmlElement 之 
前 不 要 忘 了 引入 命名 空间 。 
下 面 ， 再 来 了 解 一 些 比 较 常 用 的 配置 XML 序列 化 的 属性 。 
@ XmlAttribute: 用 户 可 以 在 公共 字段 、 属 性 、 方 法 的 参数 和 返回 值 上 使 用 该 属性 来 序 
列 化 一 个 XML 属性 。 
@ ”XmlElement: 用 户 可 以 在 公共 字段 、 属 性 、 方 法 的 参数 和 返回 值 上 使 用 该 属性 来 序列 
化 一 个 XML 元 素 。 
@ XmlIgnoreAttribute: 用 户 可 以 在 类 的 公共 属性 和 字段 上 使 用 这 个 属性 来 指定 当 序列 化 
时 需要 排除 的 字段 。 使 用 该 属性 声明 的 字段 将 不 被 序列 化 。 
@ XmlRootAttribute: 用 户 可 以 在 公共 类 的 声明 中 使 用 这 个 属性 来 指定 把 该 类 序列 化 为 
XML 文档 的 顶级 元 素 ( 即 根 元 素 )。 
@ XmlTypeAttribute: 用 户 可 以 在 公共 类 的 声明 中 使 用 这 个 属性 来 指定 它 所 对 应 的 XML 
类 型 的 名 称 和 命名 空间 。 
2) ”Web 服务 的 XML 序列 化 
.NET Framework 为 定制 Encoded 编码 格式 的 SOAP 消息 提供 了 专门 的 属性 ， 这 些 属 性 以 
Soap 开头 ， 它 们 可 以 改变 采用 Encoded 格式 编码 的 XML 序列 化 结果 。 
下 面 来 看 一 下 常用 的 控制 Encoded 格式 SOAP 消息 的 序列 化 结果 的 属性 。 
@ ”SoapAttribute: 用 户 可 以 在 公共 字段 、 属 性 、 参 数 或 返回 值 上 使 用 该 属性 来 序列 化 一 
个 XML 属性 。 
@ ”SoapElement: 用 户 可 以 在 公共 字段 、 属 性 、 参 数 或 返回 值 上 使 用 该 属性 来 序列 化 一 
个 XML 元 素 。 
@ ”SoapIgnore: 用 户 可 以 在 公共 字段 和 属性 上 使 用 这 个 属性 来 指定 在 序列 化 时 需要 排除 
的 项 。 即 在 序列 化 时 跳 过 这 些 项 。 
@ ”SoapType: 用 户 可 以 在 公共 类 的 声明 中 使 用 这 个 属性 来 指定 把 该 类 序列 化 为 XML 类 
型 ， 并 可 以 同时 指定 类 型 的 名 称 和 所 属 的 命名 空间 。 


] 
站 
Bm 


6.4.2 ”实例 描述 


在 本 例 学 习 定制 SOAP 消息 的 方法 时 , 我 突然 想到 前 段 时 间 参 与 设计 的 一 个 项 目 中 曾经 使 
用 过 类 似 的 功能 。 

这 个 功能 的 需求 是 这 样 的 ， 在 一 个 企业 内 部 的 信息 管理 系统 中 ， 需 要 向 外 发 布 一 个 接口 ， 
可 以 让 关系 密切 的 客户 通过 Web 服务 来 查询 用 户 信息 。 但 是 在 这 些 用 户 信息 中 ， 有 一 步 分 信 
息 是 用 户 个 人 的 隐私 信息 ， 这 是 不 可 以 随意 向 外 公布 的 (比如 用 户 的 个 人 联系 方式 )。 所 以 在 设 
计 这 个 Web 服务 时 ， 需 要 屏蔽 这 些 不 需要 公布 的 个 人 信息 。 

对 于 这 个 功能 , 使 用 属性 控制 XML 序列 化 的 内 容 , 就 可 以 很 方便 地 屏蔽 这 些 相关 的 信息 。 

下 面 来 看 这 个 实例 。 


< 人 mm 


6.4.3 ”实例 应 用 


【 例 6-2】 隐藏 用 户 的 隐私 信息 
(1) 准备 一 个 用 于 封装 用 户 信息 的 实体 类 UserInfo。 该 类 的 结构 如 下 所 示 : 


public class UserInfo 
{ 
private string name = string.Empty; 
private int age = 0; 
private string email = string.Empty; 
private string phone = string.Empty; 
private string mobile = string.Empty; 
public string Name 
| 
get { return name; } 
set { name = value; } 
} 
public int Age 
{ 
get { return age; } 
set { age = value; } 
public string Email 
{ 
get { return email; } 
set { email = value; } 
} 
[XmlIgnore] 
public string Phone 
{ 
get { return phone; } 
set { phone = value; } 
} 
[XmlIgnore] 
public string Mobile 
{ 
get { return mobile; } 
set { mobile = value; } 


¥ 


在 这 里 要 实现 在 Web 服务 中 屏蔽 用 户 的 电话 号 码 (Phone 属性 ) 和 手机 号 码 (Mobile 属性 ) 这 
两 项 信息 ， 所 以 在 实体 类 中 使 用 XmlIgnore 属性 声明 这 两 个 类 属性 为 XML 序列 化 的 排除 项 。 
这 样 就 实现 了 不 序列 化 这 两 项 ， 当 然 在 Web 服务 中 传递 的 时 候 也 不 会 传递 这 两 项 的 内 容 了 。 

(2) 创建 一 个 Web 服务 类 ， 命 名 为 WSUsers。 

(3) 在 Web 服务 WSUsers 中 声明 一 个 用 于 获取 用 户 信息 的 Web 方法 ， 名 为 GetUser， 添 
加 相应 的 业务 逻辑 代码 ， 如 下 所 示 : 
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[WebService (Namespace = "http://tempuri.org/")] 
[WebServiceBinding (ConformsTo = WsiProfiles-BasicProfilel 1)] 
[System.ComponentModel .ToolboxItem(false)] 
public class WSUsers : System.Web.Services.WebService 
{ 
[WebMethod] 
public UserInfo GetUser () 
{ 
return new UserInfo() 
{ 
Name = " 张 浩 华 "， 
Age = 24, 
Email = "joke.he@163.com", 
Mobile = "13888888888", 
Phone = "0371-99999999" 
] 


} 
这 里 我 们 模拟 查询 操作 , 不 接受 条 件 , 只 向 用 户 返 回 一 个 完整 的 用 户 信 息 。 需要 注意 的 是 ， 
这 里 初始 化 了 UserInfo 类 中 的 所 有 属性 ， 并 返回 给 方法 调用 者 。 


6.4.4 ”运行 结果 


使 用 浏览 器 访问 这 个 Web 服务 (URL: http://localhost: 2525/WSUsers.asmx), 如 图 6-7 所 示 。 


x 


3 -中 s 人 中 -IEU- 检 - 


WSUsers 


六 扩 T 列 作 。 末 闪 正 水 刘 义 ,主因 开明 


此 Web 服务 重用 http://tempuriorg/ 作为 村 众多 各 4- 
< 


6-7 Web 服务 WSUsers 页 面 


在 打开 的 页 面 中 单 击 GetUser 超 链接 ， 进 入 Web 方法 GetUser 的 页 面 ， 如 图 6-8 所 示 。 


GetUser 
3 
者 全 HTTP P05T 相 27 作 汪 和 可 二 ,读音 吉 “和” 基 。 


6-8 Web 方法 GetUser 页 面 
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@,.. 服务 开发 学 习 实 录 .- 扣 


在 该 页 面 中 单 击 【调用 】 按 钮 ， 浏 览 器 会 调用 Web 服务 WSUsers 的 GetUser 方法 ， 并 返 
回调 用 结果 ， 如 图 6-9 所 示 。 


图 6-9 GetUser 方法 执行 结果 


从 执行 结果 中 可 以 看 到 , Web 服务 中 虽然 初始 化 了 UserInfo 类 的 所 有 属性 ,但 是 因为 Phone 
属性 和 Mobile 属性 都 声明 为 不 序列 化 ， 所 以 这 里 只 显示 了 剩余 的 三 项 内 容 。 


6.4.5 ”实例 分 析 


me 


本 实例 实现 在 Web 服务 中 隐藏 用 户 的 信息 的 功能 ， 使 用 的 是 禁止 序列 化 实体 类 的 指定 项 

首先 使 用 System.Xml.Serialization 命名 空间 中 的 XmlIgnore 类 声明 UserInfo 类 中 不 需要 被 
XML 序列 化 的 类 属性 ， 使 Web 服务 在 序列 化 实体 信息 的 时 候 跳 过 这 些 属性 。 然 后 在 Web 服 
务 方 法 GetUser 中 创建 一 个 UserInfo 类 的 对 象 ， 初 始 化 这 个 对 象 的 所 有 属性 ， 并 返回 给 方法 调 
用 者 。 


6.5 “记录 客户 端 操作 日 志 


SOAP 扩展 是 探索 NET Web 服务 机 制 的 一 种 方法 。 

迄今 为 止 ， 我 们 使 用 的 SOAP 消息 都 是 由 Web 服务 自动 完成 的 。 比 如 解释 SOAP 请 求 和 
发 送 SOAP 响应 。 我 们 所 需 做 的 就 是 提供 一 个 Web 方法 ， 该 方法 使 用 从 SOAP 请 求 反 序 列 化 
来 的 正确 参数 ， 同 时 被 客户 端 调用 。 在 方法 执行 完成 后 ， 发 回 一 个 仍旧 包装 在 SOAP 消息 中 的 
响应 信息 。 整 个 过 程 不 用 人 为 干预 ， 系 统 自动 封装 SOAP 消息 包 。 

.NET Framework 提供 了 一 个 对 该 过 程 进行 控制 的 手段 ， 这 就 是 SOAP 扩展 。 


得 
,视频 教学 : 光盘 /videos/06/ 记 录 客 户 操作 日 志 .avi 图 长 度 : 32 分 钟 


6.5.1 基础 知识 一 一 SOAP 扩展 


客户 端 在 访问 Web 服务 时 ， 需 要 把 方法 调用 的 信息 和 方法 的 返回 结果 序列 化 为 能 够 在 网 
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络 中 传输 的 SOAP 消息 ， 以 便 能 够 简单 地 实现 Web 服务 的 远程 方法 调用 。 整 个 操作 的 通信 过 
程 如 图 6-10 所 示 。 


6-10 ”客户 端 和 服务 器 之 间 的 通信 过 程 


从 图 6-10 中 可 以 看 到 客户 端 程序 和 Web 服务 之 间 的 通信 过 程 可 以 分 为 以 下 几 步 。 


(D) 
2 
(3) 
(4) 
(5) 
(6) 
(7) 
(8) 


客户 端 创建 代理 对 象 并 调用 该 代理 对 象 的 方法 。 

客户 端 根据 代理 对 象 的 调用 ， 将 调用 操作 的 相关 信息 序列 化 为 SOAP 请 求 消息 。 
SOAP 消息 通过 Internet 发 送 到 Web 服务 器 端 。 

服务 器 端 把 接收 到 的 SOAP 消息 反 序 列 化 ， 得 到 相应 信息 。 

Web 服务 器 调用 相应 的 Web 服务 方法 ， 并 返回 方法 执行 结果 。 

Web 服务 器 端 将 返回 的 结果 序列 化 为 SOAP 消息 ， 然 后 通知 Internet 响应 给 客户 端 。 
客户 端 接收 到 服务 器 响应 的 SOAP 消息 ， 并 进行 反 序列 化 。 

代理 对 象 得 到 反 序列 化 的 数据 ， 返 回 给 方法 调用 者 。 


1. SOAP 扩展 工作 原理 


把 对 象 转换 为 XML 文本 的 过 程 称 为 序列 化 ， 把 XML 文本 解析 为 对 象 的 过 程 称 为 反 序列 
化 。 在 .NET Framework 中 ， 完 成 这 一 转换 功能 的 模块 称 为 XmlSerializer。 
在 Web 服务 中 ， 使 用 XML 序列 化 和 反 序 列 化 一 个 数据 对 象 的 过 程 如 图 6-11 所 示 。 


XML Serializer XML Serializer 


图 6-11 序列 化 和 反 序列 化 数据 


SOAP 扩展 允许 用 户 在 对 象 与 XML 转换 的 过 程 中 访问 数据 。 这 意味 着 用 户 可 以 在 SOAP 
流 序列 化 数据 前 后 访问 它 ， 然 后 再 使 用 Intemet 发 送 给 接收 方 。 在 服务 器 端 接收 到 数据 以 后 ， 


< 全 一 


执行 反 序列 化 的 过 程 中 ，SOAP 扩展 也 允许 对 数据 进行 访问 。 这 意味 着 用 户 可 以 在 反 序列 化 
SOAP 流 的 前 后 访问 这 些 数据 。 

跟踪 器 扩展 没有 实现 SOAP 消息 处 理 的 全 部 工作 。 它 只 在 消息 序列 化 之 前 和 反 序 列 化 之 后 
查看 消息 ， 或 者 把 SOAP XML 消息 写 入 磁盘 中 。 

SOAP 扩展 还 可 以 修改 SOAP 消息 的 内 容 。 比 如 可 以 在 序列 化 之 后 加 密 消息 内 容 ， 在 反 序 
列 化 之 前 解密 消息 内 容 。 


2. 创建 SOAP 扩展 


.NET Framework 为 使 用 SOAP 扩展 提供 了 很 好 的 支持 ， 它 为 用 户 提供 了 一 个 实现 SOAP 
扩展 的 基 类 SoapExtension， 和 一 个 用 于 SOAP 扩展 的 辅助 属性 类 SoapExtensionAttribute。 
在 .NET Framework 中 使 用 SOAP 扩展 需要 从 这 两 个 类 派生 自己 的 扩展 类 和 扩展 属性 类 。 
其 中 扩展 派生 类 可 以 用 于 提供 所 需 的 扩展 操作 , 扩展 属性 派生 类 可 以 用 来 指定 在 哪些 方法 上 使 
用 扩展 并 且 为 扩展 类 提供 一 些 信息 。 
使 用 SOAP 扩展 通常 可 以 包含 以 下 3 个 步骤 。 
(1) 从 SoapExtensionAttribute 类 中 派生 一 个 类 , 并 重 写 SoapExtensionAttribute 类 的 一 些 属 
性 。 当 然 还 可 以 添加 一 些 自 定义 的 属性 。 
(2) 从 SoapExtension 类 派生 一 个 扩展 类 并 重 写 它 的 方法 , 以 提供 用 户 自 定 义 的 处 理 操作 。 
(3) 把 派生 的 属性 类 应 用 到 需要 SOAP 扩展 的 方法 上 ， 或 者 在 web.config 或 app.config 配 
置 文件 中 添加 扩展 类 引用 。 
通过 上 面 这 3 个 步骤 , ASP.NETWeb 服务 就 知道 在 哪个 方法 上 添加 了 SOAP 扩展 , 并且 可 
以 使 该 方法 自动 调用 指定 的 扩展 操作 。 
1D) ”创建 SOAP 扩展 属性 类 
SOAP 扩展 属性 是 用 来 把 特定 的 方法 与 用 户 自 定义 的 SOAP 扩展 关联 起 来 。 如 果 要 在 某 个 
特定 方法 上 使 用 SOAP 扩展 ， 用 户 需要 为 其 指定 特定 的 SOAP 扩展 属性 ， 然 后 ASP.NET Web 
服务 就 能 够 从 这 个 属性 中 获取 与 该 方法 相关 联 的 SOAP 扩展 类 ， 并 在 适当 的 时 候 调 用 它 。 
创建 SOAP 扩展 属性 类 ， 我 们 可 以 使 用 .NET Framework 中 的 SoapExtensionAttribute 类 ， 
它 将 作为 用 户 自 定义 扩展 属性 类 的 基 类 。 
SoapExtensionAttribute 类 位 于 命名 空间 System.Web.Services.Protocols 中 , 它 主要 包括 下 面 
两 个 属性 。 
@ ”ExtensionType: 获取 相关 联 SOAP 扩展 的 类 型 。 在 派生 类 中 必须 重 写 这 个 属性 ， 并 通 
过 它 来 返回 特定 SOAP 扩展 的 类 型 。 
@ ”Priority: 获取 或 设置 SOAP 扩展 的 优先 级 。 我 们 在 派生 类 中 需要 重 写 这 个 属性 。 因 为 
可 能 同时 存在 多 个 SOAP 扩展 ， 所 以 需要 使 用 优先 级 来 确定 它们 的 调用 顺序 。SOAP 
扩展 的 优先 级 越 高 ， 它 所 处 理 的 SOAP 消息 就 越 接 近 于 网 络 中 传送 的 SOAP 消息 。 该 
属性 接收 大 于 或 等 于 0 的 自然 数 ， 并 且 该 属性 值 越 小 ,表示 该 扩展 的 优先 级 越 高 (0 表 
示 优 先 级 最 高 )。 
例如 ， 要 创建 一 个 保存 Web 服务 接收 和 发 送 的 SOAP 消息 的 SOAP 扩展 SaveContent 
SoapExtension， 那 么 就 需要 先 为 其 创建 一 个 扩展 属性 类 SaveContentSoapExtensionAttribute， 以 
便 使 Web 服务 方法 和 SOAP 扩展 类 关联 起 来 ， 并 设置 一 些 必 要 的 参数 。 
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下 面 这 段 代 码 就 是 从 SoapExtensionAttribute 类 中 派生 的 一 个 新 的 属性 类 SaveContent 


SoapExtensionAttribute: 


[AttributeUsage (AttributeTargets.Method)] 
public class SaveContentSoapExtensionAttribute: SoapExtensionAttribute 
public override Type ExtensionType 
{ 
get { throw new NotImplementedException(); } 
} 


public override int Priority 


throw new NotIimplementedException(); 


throw new NotIimplementedException(); 


} 


从 上 面 代码 中 可 以 看 到 ， 当 自 定义 的 类 继承 抽象 类 SoapExtensionAttribute 以 后 ， 系 统 会 要 
写 该 类 中 的 两 个 属性 ExtensionType 和 Priority。 


@ 在 上 面 代码 中 创建 扩展 属性 类 时 ， 使 用 了 AttributeUsage 属性 声明 该 扩展 属性 只 
注意 | 。 能 应 用 到 方法 成 员 上 。 
接 下 来 在 该 类 中 重 写 基 类 的 两 个 属性 : ExtensionType 和 Priority， 代 码 如 下 : 


[AttributeUsage (AttributeTargets.Method) ] 
public class SaveContentSoapExtensionAttribute : SoapExtensionAttribute 


{ 


private int priority = 2; 
public override Type ExtensionType 
{ 


get { return typeof (SaveContentSoapExtensionAttribute); } 
| 


public override int Priority 
return priority; 


priority = value; 


< 


至 此 ，SOAP 扩展 属性 类 SaveContentSoapExtensionAttribute 就 算 定 义 完成 了 。 

2) ”创建 SOAP 扩展 类 

要 使 用 SOAP 扩展 ， 还 需要 从 SoapExtension 类 派生 一 个 自 定义 扩展 类 。 比 如 前 面 讲 的 
SaveContentSoapExtension 类 ， 声 明代 码 如 下 : 


public class SaveContentSoapExtension : SoapExtension 
{ 
public override object GetInitializer(Type serviceType) 
{ 
throw new NotImplementedException(); 
} 
public override object GetInitializer(LogicalMethodInfo methodIinfo, 
SoapExtensionAttribute attribute) 
{ 
throw new NotImplementedException(); 
ji 
public override void Initialize(object initializer) 
|! 
throw new NotIimplementedException(); 
} 
public override void ProcessMessage (SoapMessage message) 
throw new NotImplementedException(); 
} 
} 


从 上 面 代码 中 可 以 看 到 ， 当 自 定义 的 类 继承 了 SoapExtension 类 以 后 ， 自 动 生成 了 一 些 方 
法 ， 说 明 这 些 方法 对 于 SOAP 扩展 类 来 说 是 必需 的 。 下 面 我 们 就 来 分 别 介绍 这 些 方 法 。 

(1) ”GetInitializer 方法 。 

在 客户 程序 或 Web 服务 执行 期 间 ，GetInitializer 方法 只 会 被 NET Framework 调用 一 次 ， 
而 且 它 的 返回 值 将 会 被 缓冲 并 作为 参数 传递 到 后 续 的 Initialize 方法 调用 。 

GetInitializer 方法 有 两 种 重 载 形式 ， 分 别 是 : 


public override object GetInitializer(Type serviceType) 


和 


public override object GetInitializer (LogicalMethodInfo methodInfo, 
SoapExtensionAttribute attribute) 


在 SOAP 扩展 类 中 ， 我 们 需要 同时 重 写 GetImitializer 方法 的 这 两 种 重 载 。 不 过 具体 .NET 
Framework 最 终 会 调用 哪个 重 载 形式 ， 以 及 什么 时 候 调 用 GetInitializer 方法 由 SOAP 扩展 的 指 
定 方式 确定 。 

如 果 通 过 在 配置 文件 中 添加 引用 的 方式 来 使 用 SOAP 扩展 , 则 在 第 一 次 访问 该 配置 文件 范 
围 内 的 所 有 Web 服务 时 ，.NET Framework 将 调用 GetInitializer 方法 的 GetlInitializer (Type 
serviceType) 重 载 形式 。 其 参数 类 型 为 Type， 表 示 自 定义 扩展 类 的 类 型 ; 返回 值 为 object， 表示 
任意 类 型 的 对 象 。 


>> 
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如 果 用 户 通过 在 方法 上 添加 属性 的 方式 来 使 用 SOAP 扩展 ， 则 在 第 一 次 访问 该 方法 
时 ，.NET Framework 将 调用 GetInitializer 方法 的 GetInitializer(Logical MethodInfo methodInfo., 
SoapExtensionAttribute attribute) 重 载 形 式 。 在 调用 GetInitialize 方法 时 ， 通 过 methodInfo 参数 ， 
可 以 获取 应 用 SOAP 扩展 的 方法 的 详细 信息 (比如 方法 的 参数 和 返回 值 等 ); 通过 attribute 参数 ， 
则 可 以 获取 与 SOAP 扩展 类 对 应 的 属性 类 的 一 些 信息 。 

(2) Initialize 方法 。 

在 第 一 次 使 用 SOAP 扩展 的 Web 服务 方法 时 ，.NET Framework 都 会 调用 Initialize 方法 。 
系统 会 自动 使 用 GetInitializer 方法 的 返回 值 对 象 做 为 参数 传递 到 这 个 方法 中 ， 用 户 可 以 使 用 这 
个 信息 来 执行 一 些 与 方法 相关 的 初始 化 操作 。 

(3) ProcessMessage 方法 。 

该 方法 是 SOAP 扩展 类 的 核心 方法 。 在 SOAP 消息 处 理 的 每 一 个 阶段 ，.NET Framework 
都 会 调用 这 个 方法 ， 并 且 会 向 它 传递 一 个 表示 SOAP 消息 的 对 象 (SoapMessage 对 象 )。 用 户 可 
以 在 这 个 方法 中 根据 消息 处 理 的 不 同 阶段 来 对 SOAP 消息 进行 相应 的 处 理 。 

如 果 SOAP 扩展 在 客户 端 运行 , 则 传递 给 这 个 方法 的 消息 对 象 将 是 一 个 SoapClientMessage 
对 象 ， 如 果 SOAP 扩展 在 服务 器 端 运行 ， 那 么 这 个 对 象 将 是 一 个 SoapServerMessage 对 象 。 

SoapMessage 对 象 表示 特定 阶段 的 SOAP 请 求 或 SOAP 响应 中 的 数据 其 中 包含 一 个 Stage 
属性 ， 可 用 于 获取 当前 操作 所 处 的 阶段 。 

Stage 属性 是 一 个 SoapMessageStage 类 的 枚 举 对 象 ， 用 于 指定 SOAP 消息 的 处 理 阶段 ， 其 
可 能 出 现 的 值 有 4 个 ， 如 表 6-4 所 示 。 


表 6-4 SoapMessageStage 枚 举 的 值 


值 说 明 

BeforeSerialize 其 值 为 1。 表示 在 序列 化 System.Web.Services.Protocols.SoapMessage 之 前 的 阶段 

i 其 值 为 2。 表示 在 序列 化 System.Web.Services.Protocols.SoapMessage 之 后 ， 但 在 
通过 网 络 发 送 SOAP 消息 之 前 的 阶段 

ee 其 值 为 4。 表 示 在 将 System.Web.Services.Protocols.SoapMessage 通过 网 络 发 送 
SOAP 消息 反 序列 化 到 对 象 之 前 的 阶段 

i 其 值 为 8。 表 示 在 将 System.Web.Services.Protocols.SoapMessage 从 SOAP 消息 
反 序 列 化 到 对 象 之 后 的 阶段 


上 面 所 讲 的 这 4 个 阶段 可 以 运行 在 客户 端 或 服务 器 端 , 客户 端 请 求 服务 器 的 操作 时 无 论 哪 
个 阶段 都 会 调用 ProcessMessage 方法 。 6-12 所 示 为 在 不 同 阶段 调用 ProcessMessage 方法 的 
情况 。 

3. 使 用 SOAP 扩展 


前 面 我 们 已 经 了 解 了 如 何 创 建 SOAP 扩展 类 和 扩展 属性 类 。 但 是 这 里 只 有 两 个 类 , 我 们 还 
无 法 确定 如 何在 Web 服务 中 调用 这 个 SOAP 扩展 。 因此 , 还 必须 指定 在 哪个 方法 中 使 用 SOAP 
扩展 。 

使 用 SOAP 的 扩展 有 两 种 方式 : 通过 SOAP 扩展 属性 来 指定 和 通过 配置 文件 来 指定 。 


< 人 mm 


BeforeDeserialize 
反 序 列 化 


AfterDeserialize 


BeforeSerialize 


客户 端 


BeforeSerialize, 


AfterSerialize 


AfterDeserialize 


BeforeDeserialize| 


SOAP 响 应 


图 6-12 不 同 阶段 调用 ProcessMessage 方法 的 情况 


1) ”使 用 SOAP 扩展 属性 为 方法 指定 SOAP 扩展 

使 用 SOAP 扩展 属性 为 方法 指定 SOAP 扩展 的 方法 非常 简单 , 我 们 只 需要 在 方法 声明 中 指 
定 前 面 所 创建 的 SOAP 扩 展 属 性 类 (比如 SaveContentSoapExtension), 并 设置 一 些 参数 就 可 以 了 ， 
其 他 操作 .NET Framework 会 自动 完成 。 

使 用 这 种 方式 需要 为 每 一 个 使 用 SOAP 扩展 的 方法 指定 SOAP 扩展 属性 。 

比如 在 Web 服务 方法 HelloWorld 的 声明 中 使 用 SaveContentSoapExtension 属性 指定 其 使 
用 SOAP 扩展 ， 并 把 SOAP 扩展 的 优先 级 设置 为 1， 代 码 如 下 所 示 : 

[WebMethod] 

[SaveContentSoapExtension (Priority = 1)] 

public string HelloWorld() 

{ 


return "Hello World"; 


2) ”使 用 配置 文件 指定 SOAP 扩展 
使 用 配置 文件 指定 SOAP 扩展 可 以 应 用 到 该 配置 文件 范围 内 的 每 个 Web 服务 中 的 每 一 个 
方法 上 。 使 用 配置 文件 的 方法 也 比较 简单 ， 只 需要 在 配置 文件 中 添加 一 个 soapExtensionTypes 
元 素 即 可 。 
5 在 Web 应 用 程序 中 , 需要 把 soapExtensionTypes 元 素 添加 到 web.config 文件 中 ; 
提示 而 在 Windows 应 用 程序 中 ， 则 要 把 soapExtensionTypes 元 素 添加 到 app. config 
Rs 


soapExtensionTypes 元 素 具 有 以 下 3 个 属性 。 

@ type: 该 属性 用 来 指定 SOAP 扩展 的 类 型 。 在 指定 这 个 属性 时 ， 需 要 指定 SOAP 扩展 
类 的 全 名 (命名 空间 加 上 类 名 ) 以 及 包含 它 的 程序 集 的 名 称 。 例 如 SOAP 扩展 位 于 
WebService 中 ， 并 且 程 序 集 名 称 也 为 WebService， 那 么 type 属性 的 配置 格式 如 下 : 


type="WebService.SaveContentSoapExtension, WebService"。 


第 6 章 简单 对 象 访问 协议 一 一 SOAP 东 


@ ”group: 该 属性 用 来 指定 该 SOAP 扩展 所 属 的 优先 组 。 在 SOAP 扩展 中 总 共有 3 个 优 
先 组 ， 分 别 是 使 用 扩展 属性 指定 的 SOAP 扩展 、 在 配置 文件 中 指定 的 组 0 以 及 在 配置 
文件 中 指定 的 组 1。 

@ priority: 该 属性 用 来 指定 SOAP 扩展 在 组 中 的 相对 优先 级 。0 表示 优先 级 最 高 。 指 定 
的 值 越 大 ， 优 先 级 越 低 。 

例如 下 面 要 在 Web 应 用 程序 中 的 配置 文件 里 添加 一 个 soapExtensionTypes 元 素 ， 指 定 

SOAP 扩展 。 代 码 如 下 : 


<configuration> 
<system.web> 
<!-- 其 他 代码 略 --> 
<webServices> 
<soapExtensionTypes> 
<add type="WebService.SaveContentSoapExtension, WebService" 
GEOUD= "I DEIOEICT= /3 
</soapExtensionTypes> 
</webServices> 
</system.web> 
</configuration> 


在 客户 端 添加 SOAP 扩展 的 过 程 与 服务 器 端 基本 相同 , 都 需要 首先 定义 扩展 类 和 扩展 属性 
类 ， 然 后 在 代理 类 的 方法 上 使 用 扩展 属性 指定 相应 的 SOAP 扩展 ， 或 者 在 配置 文件 中 使 用 
soapExtensionTypes 元 素 指定 SOAP 扩展 。 


6.5.2 ”实例 描述 


SOAP 扩展 可 以 让 我 们 在 SOAP 工作 的 过 程 中 对 SOAP 封装 的 消息 包 进行 一 些 额外 的 操 
作 。SOAP 扩展 的 用 途 有 很 多 ， 可 以 使 用 它 来 记录 请 求 、 加 密 数据 或 压缩 消息 包 。 

本 实例 在 前 面 实现 过 的 “使 用 Web 服务 上 传 和 下 载 图 片 ” 实 例 中 ， 来 添加 一 个 SOAP 扩 
展 ， 用 于 记录 客户 端 操作 日 志 。 


6.5.3 ”实例 应 用 


【 例 6-3】 记录 客户 端 操作 日 志 
(1) 在 Web 服务 器 端 创建 一 个 SOAP 扩展 类 , 命名 为 SaveLogSoapExtension, 用 于 记录 日 
志 ， 代 码 如 下 : 
public class SaveLogSoapExtension : SoapExtension 
{ 
public override object GetInitializer(Type serviceType) 
{ 


return null; 
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public override object GetInitializer(LogicalMethodInfo methodInfo, 
SoapExtensionAttribute attribute) 
| 
return null; 
} 
public override void Initialize(object initializer) { } 
public override void ProcessMessage (SoapMessage message) 
1 
Switch (message-Stage) 
{ 
case SoapMessageStage.AfterDeserialize: 
break; 
case SoapMessageStage.BeforeDeserialize: 
SaveLog (message); 
break; 
case SoapMessageStage.AfterSserialize: 
break; 
case SoapMessageStage.BeforeSerialize: 
break; 


} 
private void SaveLog (SoapMessage message) 
{ 
string filename = "D:\\log.txt"; 
FileInfo file = new FileInfo(filename); 
if (!file.Exists) file.Create(); 
using (FileStream fs = new Filestream(filename, FileMode.Append)) 
{ 
using (StreamWriter sw = new StreamWriter (fs)) 
{ 
Eee 一 二 二 ny 
if (message.Stage == SoapMessageStage.BeforeDeserialize) 
| 
Stream s = message.Stream; 
StreamReader sr = new StreamReader(s); 
sw.WriteLine(sr.ReadToEnd ()); 
s.Position = 0; 
1 
sw.WriteLine (message-RAction) 7 
sw.WriteLine (message.Stage); 
sw.WriteLine (DateTime .Now); 


. 
(2) 添加 一 个 扩展 属性 类 SaveLogSoapExtensionAttribute， 代 码 如 下 : 


[AttributeUsage (AttributeTargets.Method)] 
public class SaveLogSoapExtensionAttribute : SoapExtensionAttribute 


mB >> 
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private int priority = 1; 


public override Type ExtensionType 
get { return typeof (SaveLogSoapExtension); } 
} 
public override int Priority 
| 
get 


return priority; 


priority = value; 


} 


这 里 的 Type 属性 需要 返回 一 个 SOAP 扩展 的 类 。 在 这 个 SOAP 属性 类 的 前 面 使 用 
AttributeUsage 属性 声明 其 为 属性 用 例 ， 并 且 声 明 该 扩展 属性 只 能 使 用 在 类 上 。 
(3) 创建 好 SOAP 扩展 类 和 SOAP 扩展 属性 类 ， 下 面 在 Web 服务 中 使 用 它 ， 代 码 如 下 : 


public class WSUpload : System.Web.Services.WebService 
{ 
[WebMethod] 
[SaveLogSoapExtension] 
public byte[] GetFilel(string fileName) 
{ 
// 方 法 中 代码 省 略 


[WebMethod] 
[SaveLogSoapExtension] 
public void UploadFile (byte[] content, string fileName) 
| 
// 方 法 中 代码 省 略 
} 


6.5.4 ”运行 结果 


运行 Web 服务 项 目 ， 然 后 使 用 Windows 客户 端 再 一 次 执行 上 传 和 下 载 图 片 操作 ， 执 行 结 
果 如 图 6-13 所 示 ( 这 里 需要 注意 上 传 图 片 的 文件 名 等 信息 ， 待 会 儿 会 在 日 志 中 出 现 )。 


< 


在 这 里 向 服务 器 上 传 了 一 个 名 为 3star.gif 的 图 片 文 件 ， 然 后 请 求 服务 器 将 其 下 载 。 经 过 这 
两 个 操作 ， 服 务 器 端 应 该 记录 了 两 条 日 志 信息 ， 并 存储 了 请 求 的 内 容 。 
查看 SOAP 扩展 记录 的 日 志文 件 Di:\log.txt， 内 容 如 图 6-14 所 示 。 


[af 
| >[>[> | 


图 6-13 ”上传 和 下 载 文件 6-14 SOAP 扩展 记录 的 日 志 信息 


6.5.5 ”实例 分 析 


Cs 


本 实例 首先 创建 一 个 SOAP 扩展 类 , 在 该 类 的 ProcessMessage 方法 中 判断 SOAP 扩展 的 执 
行 状态 ,在 SOAP 消息 反 序列 化 之 前 获取 SOAP 请 求 的 信息 ,记录 用 户 请 求 的 内 容 和 其 他 相关 
信息 。 然 后 创建 一 个 SOAP 扩展 属性 类 ， 在 该 属性 类 的 ExtensionType 属性 中 返回 刚才 创建 的 
SOAP 扩展 类 ， 并 且 在 该 SOAP 扩展 属性 类 前 面 使 用 AttributeUsage 属性 声明 该 属性 只 能 应 用 
于 方法 .最 后 ,在 Web 服 务 WSUpload 中 的 上 传 和 下 载 文件 的 Web 方法 前 分 别 使 用 创建 的 SOAP 
扩展 属性 类 声明 SOAP 扩展 。 


6.6.1 SOAP 概念 的 问题 


回国 。 SOAP 概念 的 问题 . 


[2 团 。” 网络 课 堂 : http://bbs.itzcn.comy/thread-15411-1-1.html 
我 知道 SOAP 是 一 种 平台 无 关 性 的 协议 ， 也 就 是 客户 端 和 服务 器 端 可 以 是 不 同 的 语言 。 但 
通过 SOAP 来 实现 传递 信息 ， 是 一 种 什么 机 制 呢 ? 
【解决 办 法 】 
SOAP 只 是 一 种 传输 协议 。 底 层 实现 使 用 的 是 XML+HTTP， 其 实 它 可 以 运行 在 任何 文本 
传输 协议 之 上 。 
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给 你 看 一 个 SOAP 包 的 格式 : 


<?xml version="]1.0" encoding="utf-8"?> 

<soapenv:Envelope xmlns:soapenv="http://schemas .xmlsoap.org/soap/envelope/" 

xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" 

xmlns:xsd="http://www.w3.0rg/2001/xMLSchema" 

xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance"> 

<soapenv:Header> 

sy 一 尖 全 局 > 

</soapenv:Header> 

<soapenv:Body> 

<!-- 消息 主体 --> 

</soapenv:Body> 

</soapenv:Envelope> 

协议 这 种 东西 只 是 一 种 支持 应 用 的 机 制 ， 离 开 实际 的 应 用 没有 办 法 给 你 举例 子 。 如 果 你 想 
使 用 它 ， 应 该 看 具体 的 应 用 ， 比 如 Web 服务 。 


6.6.2 ”SOAP 协议 是 否 可 以 进行 文件 传输 


ly SOAP 协议 是 否 可 以 进行 文件 传输 ? 


Cg 网 络 课堂 : http://bbs.itzen.com/thread-15412-1-1.html 

SOAP 协议 是 否 可 以 进行 文件 传输 ? 

【解决 办 法 】 

SOAP 协议 是 一 种 文本 传输 协议 ， 而 文件 是 一 种 二 进 制 数 据 ， 所 以 不 能 使 用 SOAP 来 直接 
传输 文件 。 

不 过 只 要 对 二 进 制 文件 进行 一 些 转换 ， 就 可 以 使 用 SOAP 协议 传递 了 。 

以 ASP.NET 为 例 ， 使 用 基于 SOAP 协议 的 Web 服务 传输 文件 ， 可 以 将 二 进 制 文件 读 入 内 
存 ， 并 将 其 转换 为 一 个 字符 数组 ， 然 后 使 用 SOAP 协议 传输 这 个 字符 数组 即 可 。 

有 具体 传递 的 文件 大 小 ， 可 以 在 Web 服务 的 配置 文件 中 进行 限制 。 不 过 一 般 来 说 太 大 的 文 
件 不 建议 使 用 SOAP 协议 传输 ， 否 则 将 非常 浪费 应 用 程序 性 能 。 


6.7 习 题 

一 、 填 空 题 

(1) 在 一 组 完整 的 SOAP 消息 中 , 需要 包含 以 下 三 个 XML 元 素 : 元 素 、Header 
元 素 和 Body 元 素 。 

(2) 在 服务 器 端 通过 XML 序列 化 过 的 数据 ， 需 要 在 客户 端 执行 操作 以 后 才能 
被 识别 。 

(3) 要 实现 一 个 SOAP 扩展 属性 类 ， 需 要 使 自 定义 的 类 继承 自 类 。 

(4) 要 实现 一 个 SOAP 扩展 属性 类 ， 需 要 重 写 父 类 中 的 属性 和 Priority 属性 。 


< 舍 一 


(5) SOAP 扩展 类 中 的 方法 可 用 于 处 理 SOAP 消息 执行 的 每 一 个 阶段 。 
二 、 选 择 题 
(1) 在 标准 的 SOAP 消息 中 ， 以 下 三 个 部 分 中 是 不 必要 的 。 
A.，Envelope 元 素 B. Header 元 素 C. Body 元 素 
(2) 下 面 的 各 个 数据 类 型 中 ， 不 可 以 被 XML 序列 化 。 
A. Date B. String C. Li D. Stream 


(3) 下 列 说 法 中 ， 不 正确 的 一 项 是 8 
A. SOAP 协议 是 一 种 轻 量 级 的 文本 传输 协议 
B. SOAP 消息 可 以 使 用 其 他 任何 文本 传输 协议 传输 
C.，SOAP 协议 可 以 直接 用 来 传输 二 进 制 数据 
D. SOAP 使 用 XML 来 格式 化 数据 


三 、 上 机 练习 


上 机 练习 1: 实现 一 个 文件 上 传 工具 。 

前 面 讲 过 如 何 使 用 SOAP 协议 传输 二 进 制 文件 。 本 实例 我 们 就 使 用 Web 服务 来 实现 一 个 
简单 的 文件 上 传 工 具 。 

本 实例 需要 实现 浏览 本 地 文件 ， 并 上 传 选中 的 文件 的 功能 。 

具体 要 求 : 用 户 在 界面 中 可 以 选择 文件 ， 选 中 一 个 文件 后 ， 将 文件 的 完整 路 径 显示 在 窗 体 
中 ， 然 后 用 户 可 以 选择 上 传 该 文件 。 用 户 上 传 后 的 文件 名 将 以 列表 的 形式 显示 在 窗 体 中 的 列表 
控件 中 。 执 行 效果 如 图 6-15 所 示 。 


文件 路 径 : |D:\log txt 


book jpeg 


租 发 器 . txt 
827_2010512115633.rar 


6-15 ”简单 的 文件 上 传 工具 
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内 容 摘要 : 

在 使 用 分 布 式 应 用 程序 时 ， 我 们 要 解决 的 最 为 重要 的 一 个 问题 就 是 数据 交互 。 当 然 ， 在 不 
同 的 主机 间 进 行 数据 传递 ， 一 个 非常 重要 的 问题 就 是 主机 间 如 何 进 行 识别 。 

在 B/S 结构 的 应 用 程序 中 ， 所 有 的 数据 都 在 一 个 数据 中 心 一 一 Web 服务 器 中 保存 着 。 其 他 
所 有 的 客户 端 都 将 以 “请 求 一 响应 ”的 模式 请 求 Web 服务 器 ， 以 获得 Web 服务 器 中 的 数据 ， 
或 者 向 Web 服务 器 提交 数据 。 

在 Internet 中 ,任何 一 个 角落 的 计算 机 都 可 能 对 我 们 的 Web 服务 器 发 送 请 求 ， 而 且 可 能 不 
止 一 次 发 送 请 求 。 在 设计 Web 应 用 程序 时 ， 我 们 不 可 能 在 同一 个 用 户 执行 不 同 请 求 时 都 对 该 
用 户 进行 身份 验证 一 一 那样 将 非常 麻烦 。 但 是 ， 在 用 户 的 各 个 请 求 之 间 保 留 状态 信息 ， 却 是 可 
行 的 。 

在 Web 服务 器 中 ， 一 般 都 会 提供 Cookie、Application、Session 等 对 象 ， 可 以 实现 在 客户 
端 请 求 Web 服务 器 时 进行 一 些 数据 暂 存 。 但 是 使 用 这 些 服务 器 对 象 时 ， 要 注意 应 用 程序 的 设 
计 问 题 。 任 何不 合理 的 状态 保存 方案 都 将 削弱 大 批量 用 户 请 求 时 的 服务 器 性 能 。 

本 章 我 们 就 来 详细 了 解 一 下 在 设计 Web 服务 时 ， 如 何 对 客户 端的 状态 信息 进行 保持 ， 如 
何 对 Web 服务 的 状态 信息 进行 管理 。 

学 习 目标 : 

@ 了 解 ASPNET 中 的 状态 管理 
掌握 会 话 状态 的 使 用 方法 
掌握 客户 端 Cookie 状态 的 使 用 方法 
掌握 应 用 程序 间 的 状态 信息 管理 


7.1 Web 服务 状态 管理 分 析 


随 着 近 几 年 的 发 展 ，Web 应 用 程序 成 了 企业 应 用 程序 设计 变革 的 催化 剂 。 随 着 Web 应 
用 程序 的 发 展 ， 我 们 必须 保证 应 用 程序 在 接收 多 个 不 同 请 求 时 保持 状态 ， 或 者 进行 一 些 数 据 
共享 。 

ASPNET 在 应 用 程序 层 和 用 户 会 话 层 两 个 方面 为 管理 状态 提供 了 一 些 服务 端的 元 素 ， 可 
以 实现 在 Web 应 用 程序 中 的 不 同 请 求 之 间 进 行 状态 保持 的 功能 。 

下 面 来 了 解 一 下 ASP.NET 为 我 们 提供 的 这 些 状 态 保持 的 机 制 。 


9 
上 于.' 视频 教学 : 光盘 /videos/07/Web 服务 状态 管理 分 析 .avi 人 长度: 7 分 名 


在 设计 一 个 Web 服务 时 ， 需 要 考虑 的 重要 问题 就 是 : 是 否 在 请 求 之 间 保 留 关 于 客户 和 服 
务 所 完成 工作 的 状态 信息 。 如 果 状 态 保持 设计 的 不 合理 ， 那 么 将 会 严重 影响 应 用 程序 的 性 能 。 


1. 关于 如 何 使 用 状态 保持 的 问题 


状态 管理 始终 是 程序 开发 中 非常 令 人 关注 的 一 个 话题 ， 尤 其 是 在 使 用 Web 应 用 程序 的 时 
候 。 
因为 Web 应 用 程序 使 用 的 HTTP 协议 是 一 个 无 状态 协议 ， 所 以 连接 很 少 会 超过 几 分 钟 ， 
一 般 来 说 也 就 几 秒 钟 而 已 。 
在 所 有 的 Web 应 用 程序 中 ， 服 务 器 对 用 户 的 会 话 信息 的 保持 一 般 有 以 下 三 种 方式 。 
@ 无 会 话 状态 方式 : 这 种 方式 在 用 户 请 求 以 后 ， 一 旦 断 开 连接 ， 用 户 的 状态 信息 自动 
失效 。 
@ 在 客户 端 保留 信息 : 这 种 方式 需要 每 次 都 将 会 话 的 状态 信息 通过 网 络 发 送 到 服务 器 
上 ， 服 务 器 处 理 完 以 后 将 新 的 会 话 状态 信息 发 送 给 客户 端 。 这 种 方式 不 会 额外 占用 服 
务 器 的 内 存 ， 但 是 却 会 有 较 高 的 网 络 开销 ， 增 加 了 网 络 中 的 数据 流量 。 
@ 在 服务 器 端 保留 信息 : 这 种 方式 对 于 网 络 的 开销 很 低 ， 但 是 却 需要 额外 占用 服务 器 的 
) 内 存 资源 。 
上 面 三 种 方式 中 ， 如 果 只 考虑 应 用 程序 的 性 能 ， 第 一 种 方式 应 该 是 最 佳 的 解决 方案 。 但 是 
如 果 没 有 会 话 信 息 ， 在 实现 一 些 功能 的 时 候 就 会 非常 困难 ， 对 于 程序 开发 人 员 来 说 ， 这 种 方式 
并 不 可 取 。 
对 于 程序 开发 人 员 而 言 , 在 服务 器 端 保留 状态 信息 的 方法 是 最 方便 的 。 它 不 仅 能 简化 代码 ， 
而 且 还 可 以 像 设计 本 地 类 方法 一 样 设计 Web 服务 方法 。 不 过 这 种 方式 对 内 存 的 消耗 较 大 。 在 
有 数 干 或 数 万 个 客户 同时 访问 的 时 候 ， 会 话 信息 所 占用 的 内 存 将 是 非常 巨大 的 数字 。 
在 客户 端 保存 的 信息 比较 持久 ， 更 能 客观 地 体现 用 户 的 活动 状态 ， 而 且 也 不 会 占用 太 多 的 
服务 器 的 内 存 。 但 是 ， 如 果 在 客户 端 保存 的 状态 信息 要 在 服务 器 端 使 用 ， 就 需要 在 客户 端 和 服 
务 器 端 之 间 互 相传 递 。 如 果 数 据 量 大 并 且 用 户 量 也 很 大 ， 对 服务 器 的 网 络 性 能 也 是 一 个 非常 严 
峻 的 考验 。 
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总 之 ,现存 的 这 些 状 态 机 制 都 存在 一 些 缺点 。 我 们 如 果 要 设计 一 个 合理 的 Web 应 用 程序 ， 
就 需要 详细 地 分 析 现 实 的 状况 ， 进 行 合理 的 处 理 。 


2. ASP.NET 中 关于 状态 管理 的 设计 


在 ASPNET 中 , 提供 了 一 些 状 态 管理 的 基础 架构 。 使 用 诸如 Application、Session、Cookie 
等 服务 器 端 对 象 ， 可 以 实现 用 户 从 一 个 HITP 请 求 到 下 一 个 HTTP 请 求 的 状态 保持 功能 。 

使 用 .NET Framework 实现 的 Web 服务 利用 了 ASP.NET 的 构造 ， 所 以 和 其 他 ASP.NET 应 
用 程序 一 样 具 有 状态 管理 的 功能 。 

ASP.NET 对 象 模式 为 Web 服务 中 的 状态 管理 保持 了 下 面 这 些 常用 的 核心 功能 。 

@ ”通过 使 用 Cookie 或 查询 字符 串 ， 为 保持 用 户 的 身份 提供 了 一 个 机 制 。 

@ ”通过 使 用 Session 和 Application 等 固有 的 服务 器 端 对 象 提供 了 一 个 保存 用 户 的 状态 信 

息 的 机 制 。 

在 ASPNET 中 ，Session 对 象 和 Application 对 象 是 我 们 在 Web 服务 应 用 程序 中 管理 状态 
时 使 用 的 最 重要 的 技术 。 

Session 对 象 提 供 了 保存 单个 会 话 的 状态 信息 的 功能 ,Application 对 象 提供 了 存储 所 有 Web 
应 用 程序 中 的 会 话 都 可 以 访问 的 状态 信息 的 功能 。 每 个 Web 应 用 程序 的 用 户 都 对 应 一 个 会 
(Session 对 象 )， 而 所 有 的 用 户 使 用 的 Application 对 象 是 同一 个 。 图 7-1 说 明了 Web 应 用 程序 
的 用 户 与 会 话 和 Application 对 象 的 关系 。 


Web 应 用 程序 


| 


图 7-1 用 户 与 会 话 和 Application 对 象 的 关系 


7.2 ”记录 操作 日 志 的 简单 计算 器 


因为 Web 请 求 是 一 种 无 状态 的 请 求 。 客 户 端 在 请 求 Web 服务 器 以 后 ，Web 服务 器 会 对 客 
户 端的 请 求 做 出 响应 。 响 应 结束 后 连接 断 开 互相 就 不 认识 了 ， 下 一 次 请 求 就 又 是 一 次 全 新 的 请 
求 和 响应 的 过 程 。 

不 过 客户 端 对 一 个 Web 服务 器 往往 不 会 只 做 一 次 请 求 ， 所 以 客户 端 和 服务 器 双方 需要 对 
多 次 的 请 求 、 响 应 状态 进行 保存 ， 以 备 下 次 请 求 的 时 候 使 用 。 

在 ASPNET 中 ， 使 用 Session 对 象 可 以 很 方便 地 实现 对 每 一 个 用 户 的 状态 信息 进行 保存 ， 


005 


以 方便 该 用 户 在 多 次 请 求 中 重复 使 用 保存 的 状态 信息 。 
本 节 详 细 介 绍 ASPNET 是 如 何 使 用 会 话 (Session 对 象 ) 记 录 会 话 状态 信息 的 。 
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7.2.1 基础 知 让 "一 一 会 话 管理 对 象 Session 


我 们 可 以 把 “会 话 ” 理 解 为 一 个 用 户 与 XML Web 服务 之 间 的 通信 过 程 ， 一 个 会 话 过 程 中 
可 以 有 多 次 “请 求 /响应 ”的 过 程 。 

就 像 两 个 人 之 间 的 谈话 ， 每 说 一 次 话 ， 对 话 的 双方 就 完成 了 一 次 “请 求 /响应 ”。 这 样 在 
完成 无 数 次 的 “请 求 /响应 ”以 后 ， 也 就 是 说 很 多 句 话 以 后 ， 结 束 谈 话 才 算 一 次 会 话 过 程 结束 。 

简单 地 说 ，Web 应 用 程序 中 的 会 话 ， 就 是 对 应 一 个 特定 的 用 户 对 服务 器 连续 请 求 的 过 程 。 
对 于 这 里 的 “用 户 ”， 在 使 用 浏览 器 的 时 候 是 指 当前 浏览 器 ; 在 请 求 Web 服务 的 时 候 是 指 该 
Web 服务 客户 端 应 用 程序 使 用 的 代理 类 。 

因为 HITP 是 无 状态 协议 ， 所 以 无 法 知道 不 同 的 请 求 是 否 来 自 同一 个 用 户 。 而 如 果 我 们 把 
用 户 会 话 的 状态 信息 保存 起 来 就 可 以 在 多 次 “请 求 /响应 ”的 过 程 中 使 用 这 些 数据 ， 以 实现 一 
些 特定 的 功能 。 

例如 ,在 设计 网 上 商店 系统 的 购物 车 功能 时 ， 可 以 将 网 上 购物 的 过 程 分 为 几 个 步骤 ， 即 查 
找 商品 、 挑 选 商品 、 管 理 购物 车 、 结 账 等 ， 如 图 7-2 所 示 。 


7-2 ”网 上 购物 操作 流程 


在 这 多 次 请 求 当 中 ,我 们 需要 将 用 户 多 次 请 求 的 信息 保存 在 这 个 会 话 中 ， 以 便 下 次 请 求 时 
使 用 。 

在 ASPNET 中 ,对 于 客户 端 与 服务 器 之 间 的 会 话 信息 的 管理 就 需要 使 用 Session 对 象 。 我 
们 可 以 把 每 次 请 求 中 需要 被 下 次 请 求 访问 的 信息 保存 到 Session 中 ， 以 供 下 次 请 求 使 用 。 

因为 一 个 会 话 与 特定 的 用 户 相关 联 ， 所 以 需要 使 用 一 种 方式 将 用 户 与 服务 器 端的 Session 
对 象 关联 起 来 ， 以 便 能 够 在 多 个 “请 求 /响应 ”过 程 中 区 分 它们 。 每 一 个 Session 都 是 一 个 对 象 ， 
每 一 个 Session 对 象 都 有 一 个 唯一 标识 ， 即 SessionID。 客 户 端 在 请 求 Web 服务 器 时 ，Web 服 
务 器 会 在 必要 的 时 候 为 每 一 个 请 求 创建 一 个 Session 对 象 ， 并 分 配 一 个 SessionID ， 这 个 
SessionID 就 随 Cookie 发 送 到 客户 端 ,服务 器 在 接收 到 客户 端的 请 求 以 后 ,根据 请 求 中 的 Cookie 
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里 保存 的 SessionID 来 区 分 每 一 个 用 户 。 
”如 果 客 户 程 序 支持 Cookie， 则 SessionID 将 随 着 Cookie 自动 发 送 。 否则 ，ID 将 会 
旦 示 | 。 作为 请 求 的 URL 的 一 部 分 进行 发 送 。 
服务 器 端的 Session 对 象 其 实 就 是 一 个 类 似 于 字典 的 东西 , 我 们 可 以 把 Session 对 象 看 作 一 
个 字典 或 哈 希 表 。 
我 们 知道 字典 是 以 “ 键 / 值 ”对 的 形式 保存 数据 的 ， 所 以 可 以 使 用 以 下 方式 将 数据 保存 到 


Session 中 : 


Session["Age"] = 247 


访问 Session 中 的 对 象 也 可 以 通过 指定 的 “ 键 ”来 访问 。 例 如 用 下 面 的 代码 可 以 从 Session 
对 象 中 读 取 刚 才 保存 的 值 : 


int age = (int)Session["Rge"]7 


1. 初始 化 和 释放 会 话 状态 

初始 化 Session 对 象 的 方法 非常 简单 ， 直 接 使 用 Session 对 象 为 指定 的 键 赋值 即 可 。 

Session 对 象 字典 是 一 个 object 类 型 的 字典 ， 所 以 可 以 在 其 中 保存 任何 类 型 的 数据 ， 而 从 
Session 中 读 取 数 据 时 ， 进 行 相应 的 类 型 转换 即 可 。 如 下 : 


string name = " 张 小 涛 " 
Session["Name"] = name; 


if(null != Session["Name"]) 

{ 
object oname = Session["Name"]; 
string username = (String)oname; 


} 


前 面 说 过 ，Session 是 一 个 对 象 ， 那 它 是 在 什么 时 候 创建 的 呢 ? 这 里 我 们 只 是 直接 存 取 ， 
而 没有 使 用 new 之 类 的 关键 字 去 创建 它 。 其 实 ， 在 一 次 会 话 过 程 中 ， 第 一 次 使 用 Session 对 象 
时 ， 系 统 就 自动 创建 了 该 Session 对 象 。 


$ 如 果 在 第 一 次 使 用 Session 对 象 或 者 用 户 的 会 话 超时 的 时 候 ， 使 用 Session 对 象 就 
注意 | 。 必须 进行 非 空 判断 ， 否 则 就 会 抛 出 异常 信息 。 


既然 使 用 Session 对 象 时 ， 需 要 保证 这 个 Session 对 象 的 值 不 能 为 室 ， 那 么 我 们 能 不 能 在 
Session 创建 的 时 候 自动 初始 化 Session 中 的 数据 呢 ? 答案 当然 是 可 以 的 。 

所 有 的 ASP.NET Web 应 用 程序 都 可 以 包含 一 个 名 为 global.asax.cs 的 文件 ,在 这 个 文件 中 ， 
我 们 可 以 添加 应 用 程序 启动 和 终止 或 会 话 创建 和 销毁 的 处 理 代码 。 

其 中 ,处 理会 话 创建 的 方法 名 为 Session_Start。 当 应 用 程序 创建 Session 对 象 时 ,ASP.NET 
都 会 调用 这 个 方法 。 所 以 可 以 将 初始 化 Session 的 代码 添加 到 Session_Start 方法 中 。 这 样 每 当 
启动 新 的 会 话 时 ， 系 统 将 自动 使 用 Session_Start 方法 中 的 代码 初始 化 新 创建 的 会 话 。 

例如 要 在 Session 中 初始 化 一 个 用 户 的 登录 名 称 为 空 字符 串 ， 可 以 这 样 修改 Session_Start 


< 人 mm 
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方法 : 


void Session Start (object sender, EventArgs e) 
{ 
Session["LoginName"] = ""; 


} 


2. 在 Web 服务 中 使 用 会 话 状态 


如 果 在 Web 服务 中 使 用 会 话 状态 ， 则 Web 服务 类 必须 要 继承 自 System.Web.Services. 
WebService 类 。 该 类 中 声明 了 Session、Application、Server、Context 等 服务 器 端 对 象 ， 类 声明 
如 下 : 

public class WebService : MarshalByValueComponent 


{ 


public WebService(); 


public HttpApplicationstate Application { get; } 
public HttpContext Context { get; } 
public HttpServerUtility Server { get; } 
public HttpSessionState Session { get; } 
public SoapProtocolVersion SoapVersion { get; } 
public IPrincipal User { get; } 

} 


在 Web 服务 类 继承 自 System.Web.Services.WebService 类 以 后 , 还 需要 设置 Web 服务 方法 
的 WebMethod 属性 的 EnableSession 选项 ， 将 其 值 设置 为 tue， 代 码 如 下 所 示 : 


public class WebServicel : System.Web.Services.WebService 
{ 
[WebMethod (EnableSession = true)] 
public string HelloWworld() 
{ 
return (string)Session["Hello"]; 
E 


3. 配置 会 话 状态 


如 果 要 在 ASP.NET 应 用 程序 中 管理 和 配置 会 话 的 属性 ， 需 要 在 应 用 程序 配置 文件 中 添加 
对 Session 的 配置 。 配 置 Session 需要 在 web.config 文件 中 的 system.web 节点 下 面 添加 一 个 
sessionState 节点 。 

默认 情况 下 ， 会 话 状态 已 经 在 NET Framework 的 配置 文件 中 有 相应 的 值 。 下 面 代码 是 在 
系统 的 .NET Framework 目录 中 的 配置 文件 中 的 Session 配置 信息 : 


<sessionState mode="InProc" 
stateConnectionstring="tcpip=loopback:42424" 
stateNetworkTimeout="10" 
sqlConnectionstring="data source=localhost;Integrated Security=SSPI™ 
sqlCommandTimeout="30"™ 
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sqlConnectionRetryInterval="0" 


customProvider="" 


cookieless="UseCookies" 
cookieName="ASP.NET _ SessionId" 
timeout="20"™ 


allowCustomSsqlDatabase="false" 


compressionEnabled="false" 


regenerateExpiredSessionId="true™" 


partitionResolverType="" 


useHostingIdentity="true"™" 


sessionIDManagerType=""> 
<providers> 


<clear /> 


</providers> 
</sessionstate> 


@@” 虽然 系统 的 配置 文件 中 设置 有 默认 的 Session 配置 ， 但 是 如 果 有 必要 ， 我 们 可 以 在 
提示 Web 应 用 程序 中 添加 一 个 sessionState 节点 并 设置 其 相应 的 值 。 
从 上 面 代码 中 可 以 看 到 ， 系 统 提供 Session 配置 的 属性 非常 多 。 但 是 在 这 些 属性 中 ， 最 常 


用 的 也 只 有 mode 、 stateConnectionString 、 sqlConnectionString 、 cookieless 、 timeout 、 
stateNetworkTimout 等 。 关 于 这 些 配置 属性 ， 详 细 说 明 如 表 7-1 所 示 。 


表 7-1 sessionState 节点 常用 配置 


名 称 描 述 
指定 会 话 状态 的 存储 位 置 ， 包 括 Inproc、StateServer、SqlServer 和 Off 四 个 选项 。 其 
mode 中 Off 选项 用 于 禁用 会 话 状态 。 对 于 剩余 的 三 项 ， 我 们 将 在 下 文中 详细 介绍 它们 的 
功能 
Oe 设置 Session 信息 存储 在 状态 服务 中 时 使 用 的 服务 器 名 称 和 端口 号 。 当 mode 属性 的 
值 为 StateServer 时 ， 这 个 属性 是 必需 的 
_ 设置 Session 信息 存储 在 SQL Server 数据 库 中 时 使 用 的 SQL Server 连接 字符 串 。 当 
SConestonSn ng | mode 属性 为 SQL Server 时 ， 这 个 属性 是 必需 的 
指定 是 否 不 使 用 Cookie 来 标识 会 话 。 默 认 值 为 UseCookies( 使 用 Cookie)。 另 外 还 可 
以 设置 为 true 或 false。 如 果 不 使 用 Cookie， 系 统 则 自动 将 会 话 ID 编码 到 URL 中 
站 指定 会 话 可 以 处 于 空间 状态 的 时 间 ， 单 位 为 分 钟 ， 默 认 值 为 20， 即 会 话 空闲 20 分 
钟 以 后 自动 销毁 
_ 设置 当 使 用 StateServer 模式 存储 Session 状态 时 ， 经 过 多 久 空 闲 时 间 以 后 断 开 服务 
stateNetworkTimout 


器 与 存储 状态 信息 的 服务 器 之 间 的 TCP/IP 连接 。 单 位 是 秒 ， 默 认 值 是 10 秒 钟 


4. 会 话 状态 的 存储 方式 
刚才 我 们 了 解 了 ASP.NET 应 用 程序 中 的 会 话 状 态 可 以 存储 在 不 同 的 地 方 ， 下 面 进一步 了 
解 ASP.NET 支持 的 这 三 种 会 话 状 态 存 储 方式 。 


< 全 mm 


有 2 之 


Inproc: 在 ASPNET 工作 进程 (aspnet wp.exe) 中 存储 会 话 状态 信息 。 这 种 方式 存储 的 
会 话 信息 访问 速度 最 快 ， 但 是 却 最 不 稳定 。 因 为 如 果 ASPNET 工作 进程 因为 某 种 原 
因 被 终止 ， 所 有 保存 在 其 中 的 会 话 状态 信息 也 将 全 部 丢失 。 

StateServer: 在 ASPNET 工作 进程 外 的 另 一 个 单独 进程 (aspnet state.exe) 中 存储 会 话 
状态 信息 。 这 种 方式 下 会 话 状态 由 另外 一 个 单独 的 进程 来 维护 ， 而 且 该 进程 可 位 于 另 
一 台 服 务 器 上 。 这 种 方式 的 好 处 是 会 话 状态 不 会 受 ASPNET 应 用 程序 进程 的 影响 ， 
即使 ASPNET 应 用 程序 意外 终止 ， 会 话 状态 也 不 会 全 部 丢失 。 这 种 方式 的 另外 一 个 
好 处 是 可 以 在 多 台 服 务 器 之 间 共 享 会 话 状态 信息 。 

SqlServer: 在 SQL Server 数据 库 中 存储 会 话 状态 信息 。 这 种 方式 保存 的 会 话 信息 非常 
稳定 , 但 是 访问 速度 最 慢 。 因 为 会 话 信息 保存 在 一 个 SQL Server 数据 库 中 ， 而 不 是 在 
服务 器 内 存 中 ， 所 以 即使 服务 器 被 关闭 ， 会 话 状态 也 不 会 丢失 ， 并且 可 以 永久 地 保存 
下 来 。 但 由 于 每 次 请 求 都 需要 额外 访问 SQL Server 数据 库 , 所 以 运行 速度 也 较 前 两 种 
慢 很 多 。 


实例 描述 


Session 对 象 可 以 在 服务 器 端 为 每 一 个 访问 服务 器 的 用 户 保存 一 组 状态 信息 。 当 然 在 一 些 
使 用 Web 服务 的 窗 体 应 用 程序 中 ， 我 们 也 可 能 需要 在 一 次 会 话 中 请 求 多 次 服务 器 。Web 服务 
器 不 可 能 每 一 次 请 求 都 对 客户 端 进行 一 次 验证 , 所 以 可 以 使 用 会 话 来 保持 窗 体 应 用 程序 在 Web 
服务 器 上 的 会 话 状态 。 

本 实例 ， 使 用 一 个 异步 执行 的 计算 器 程序 来 演示 在 Web 服务 中 的 会 话 的 用 法 。 


7.2.3 


实例 应 用 


【 例 7-1】 记录 操作 日 志 的 简单 计算 器 


(D 


创建 一 个 执行 计算 操作 的 Web 服务 ， 名 为 WSCounter。 在 这 个 Web 服务 类 中 ， 需 要 


执行 三 个 操作 :一 个 加 法 操作 、 一 个 减法 操作 和 一 个 登录 用 户 的 操作 。 


这 号 


需要 在 执行 加 减法 操作 时 记录 是 哪个 用 户 执 行 的 操作 ， 所 以 要 求 使 用 Session 保存 用 


户 登录 的 状态 信息 。 


WSI 


Counter 类 的 完整 代码 如 下 : 


pub. 
{ 


lic class WSCounter : System.Web.Services.WebService 


[WebMethod (EnableSession = true)] 

public void Login (string username) 

{ 

Session["User"] = username; 

} 

[WebMethod (EnableSession = true)] 

public Result Add(decimal vl1l, decimal v2) 
{ 


} 
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Result result = new Result(); 

if (null == Session["User"]) 

{ 
result .Message = "你 没有 合法 权限 "; 
result.Value = 0; 

} 

else 

{ 
result.Message = Session["User"] + "于 "+ DateTime.Now + "执行 了 
加 法 操作 "; 
result.Value = v1 + v2; 

} 


return result; 


[WebMethod (EnableSession = true)] 
public Result Subtract (decimal vl, decimal v2) 


{ 


Result result = new Result(); 

if (null == Session["User"]) 

{ 
result .Message = "你 没有 合法 权限 "; 
result.Value = 0; 

k 

else 

{ 
result.Message = Session["User"] + "于 "+ DateTime.Now + " 执行 了 
减法 操作 "; 
result.Value = v1 - v2; 

E 


return result; 


(2) 这 里 用 到 一 个 封装 执行 结果 的 自 定义 类 Result， 封 装 了 执行 结果 和 提示 信息 ， 代 码 


public class Result 


public decimal Value { get; set; } 
public string Message { get; set; } 


(3) 发 布 这 个 Web 服务 ， 然 后 在 客户 端 应 用 程序 中 添加 对 该 Web 服务 的 Web 引用 。 


客户 端 必须 添加 “Web 引用 ”， 因 为 在 调用 Web 服务 时 需要 设置 代理 类 的 一 些 信 
息 ， 所 以 使 用 “服务 引用 ”不 能 实现 该 功能 。 


(4 在 窗 体 应 用 程序 的 计算 器 窗 体 中 声明 一 个 该 Web 服务 的 代理 类 变量 ， 并 在 构造 方法 
中 初始 化 CookieContainer 属性 ， 代 码 如 下 : 


< 付 一 


b 服务 开发 学 习 实录 


public partial class Counter : Form 

{ 
localhost.WSCounter wsc = new localhost.WSCounter(); 
public Counter() 


{ 
WSsC.CookieContainer = new System.Net.CookieContainer(); 
InitializeComponent (); 

} 

// 其 他 代码 略 


@ $ 因为 窗 体 应 用 程序 不 是 浏览 器 ,所 以 代理 类 中 并 不 能 创建 存储 Cookie 集合 的 对 象 ， 
注意 | 需要 手动 初始 化 CookieContainer 属性 。 


(5) 下 面 来 实现 用 户 登录 的 功能 。 下 面 的 代码 接收 用 户 在 窗 体 中 输入 用 户 名 ,使 用 代理 类 
调用 Web 服务 执行 登录 功能 ， 代 码 如 下 : 


private void btnLogin Click(object sender, EventArgs e) 
有 
string username = this.txtUsername.Text; 
if (username.Trim() != string.Empty) 
{ 
wsc.Login (username); 
this.lstLog.Items.Add ("用户 " + username + "” 登录 成 功 ") 7 


} 
(6) 实现 执行 加 减法 功能 的 方法 ， 代 码 如 下 : 


private void btnSub Click(object sender, EventArgs e) 

{ 
decimal vl = decimal.Parse(this.txtValuel.Text); 
decimal v2 = decimal.Parse (this.txtValue2.Text); 
Var result = wsc.Subtract (vl, v2); 
this.lblResult.Text = result.Value.ToString(); 
this.lstLog.Items.Add (result.Message); 

} 

private void btnAdd Click(object sender, EventArgs e) 

{ 
decimal vl = decimal.Parse (this.txtValuel.Text); 
decimal v2 = decimal.Parse (this.txtValue2.Text); 
Var result = wsc.Add(vl, v2); 
this.lblResult.Text = result.Value.ToString(); 
this.lstLog.Items.Add (result.Message); 

} 


在 接收 到 用 户 输入 的 值 以 后 ， 使 用 代理 类 对 象 调用 Web 服务 ， 执 行 完成 以 后 在 窗 体 中 显 
示 执 行 结果 。 


Esc) >> 
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7.2.4 ”运行 结果 


首先 运行 Web 服务 所 在 的 Web 应 用 程序 。 

然后 ， 运 行 窗 体 应 用 程序 ， 分 别 在 Numl 和 Num2 文本 框 中 输入 两 个 数 ， 单 击 【 减 法 】 按 
钮 ， 系 统 提 示 “ 你 没有 合法 权限 ”， 如 图 7-3 所 示 。 

在 【用 户 名 】 文本 框 中 输入 Joker， 单 击 【 登 录 】 按 钮 。 应 用 程序 会 使 用 该 用 户 名 向 Web 
服务 器 执行 登录 ， 执 行 结果 如 图 7-4 所 示 。 


结果 
人 没有 合法 起 限 


图 7-3 没有 合法 权限 图 7-4 用 户 登录 成 功 


登录 成 功 以 后 ， 再 单 击 【 减 法 】 按 钮 ， 窗 体 中 将 显示 执行 结果 ， 如 图 7-5 所 示 。 
当然 单 击 【加 法 】 按 钮 一 样 可 以 得 到 相应 的 结果 ， 如 图 7-6 所 示 。 


加 [aE 加 [se 


用 户 各 : [Tokar 


nls 


I 


有 全 法 
[i 322.16 执行 了 着 法 兴 作 


的 交 站 


图 7-5 执行 减法 操作 图 7-6 执行 加 法 操作 


7.2.5 “实例 分 析 


rn 


本 实例 中 ， 首 先 在 WebService 中 创建 三 个 Web 服务 方法 ， 分 别 执行 登录 、 加 法 、 减 法 操 
作 。 在 执行 登录 操作 时 将 用 户 提交 的 用 户 名 保存 到 Session 中 ， 然 后 在 加 、 减 法 操作 中 使 用 
Session 中 的 用 户 名 组 织 相 应 的 提示 信息 ， 接 下 来 在 客户 端 添加 对 该 Web 服务 的 Web 引用 。 最 
后 创建 一 个 代理 类 对 象 ， 并 设置 一 个 Cookie 集合 。 在 窗 体 应 用 程序 中 分 别 使 用 这 些 方法 进行 
相应 的 运算 操作 ， 并 显示 执行 结果 。 


< 浙 一 


7.3 使 用 Application 统计 系统 的 在 线 人 数 


我 们 知道 Web 应 用 程序 是 多 线程 的 ， 所 以 在 设计 Web 系统 时 可 以 不 考虑 不 同 用 户 间 的 信 
息 冲 突 问题 。 但 是 应 用 程序 可 能 需要 在 不 同 的 用 户 之 间 共 享 一 些 信息 ， 或 者 多 个 用 户 共 同 维护 
一 个 数据 信息 。 这 个 时 候 就 需要 考虑 设计 一 个 多 个 线程 间 都 能 访问 一 组 信息 的 功能 。 

幸运 的 是 ，ASPNET 提供 了 一 个 名 为 Application 的 服务 器 端 对 象 ， 可 以 让 我 们 在 不 同 的 
用 户 间 使 用 同一 组 共享 的 数据 ， 达 到 数据 共享 的 功能 。 

下 面 来 详细 了 解 Application 对 象 是 如 何在 Web 服务 中 实现 不 同 用 户 间 的 数据 共享 的 。 


ce 视频 教学 : 光盘 /videos/07/ 统 计 系统 在 线 人 数 .avi Bk* 度 : 13 分 名 


7.3.1 基础 知识 一 一 应 用 程序 对 象 Application 


会 话 状态 可 以 保存 单个 用 户 的 数据 ， 而 应 用 程序 对 象 保存 的 是 整个 应 用 程序 的 全 局 数据 。 
也 就 是 说 在 应 用 程序 对 象 中 保存 的 数据 可 以 在 整个 应 用 程序 的 范围 内 访问 。 

通常 将 一 些 应 用 程序 内 共享 的 少量 数据 保存 在 应 用 程序 对 象 Application 中 。Application 
中 保存 的 数据 总 是 在 ASP.NET 应 用 程序 进程 内 部 处 理 ， 不 能 在 多 个 服务 器 之 间 共 享 或 异地 存 
储 。 另 外 ， 应 用 程序 状态 Application 也 不 像 Session 一 样 ， 不 需要 使 用 Cookie。 


1. 应 用 程序 状态 的 使 用 

可 以 把 Application 对 象 看 作 存储 全 局 信息 的 容器 ， 它 也 是 通过 “ 键 / 值 ”对 的 形式 来 存储 
数据 的 。 在 Web 服务 中 ，Application 对 象 可 以 通过 WebService 类 的 Application 属性 来 访问 。 

下 面 的 代码 演示 了 如 何 向 Application 对 象 中 保存 信息 以 及 如 何 从 Application 中 取出 信息 : 


// 保 存 信息 

Application["Count"] = 20; 

// 取 出 信息 

int count = (int)Application["Count"]; 


@ ”Application 对 象 和 Session 对 象 相同 ， 是 一 个 object 类 型 的 字典 。 所 以 我 们 在 从 
注意 Application 对 象 中 读 取 数 据 的 时 候 需要 进行 相应 的 类 型 转换 。 


同 会 话 状 态 Session 相同 ,应 用 程序 状态 Application 可 以 在 应 用 程序 全 局 文件 global.asax.cs 
中 进行 初始 化 ， 也 可 以 在 访问 时 进行 初始 化 。 

与 会 话 状态 Session 不 同 的 是 : 应 用 程序 的 状态 是 全 局 性 的 ， 所 以 可 以 在 应 用 程序 启动 的 
时 候 对 它 进 行 初 始 化 。 

在 global.asax.cs 文件 中 ， 应 用 程序 启动 的 事件 处 理 方法 是 Application_Start， 我 们 可 以 在 
该 方法 中 编写 代码 初始 化 Application 对 象 ， 代 码 如 下 : 

void Application Start (object sender, EventArgs e) 

{ 


m= 地)>> 
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Application["Count"] = 20; 
} 


2. 解决 使 用 应 用 程序 状态 时 的 多 线程 冲突 

在 使 用 应 用 程序 对 象 时 ， 需 要 注意 的 问题 是 应 用 程序 对 象 的 访问 冲突 。 

因为 应 用 程序 状态 是 全 局 性 的 ， 可 以 被 多 个 用 户 访问 ， 所 以 在 同一 时 刻 ， 可 能 会 有 多 个 用 
户 在 访问 它 ， 这 可 能 会 造成 应 用 程序 对 象 的 访问 冲突 问题 。 

例如 要 实现 一 个 访问 量 统计 的 功能 ， 把 访问 量 信息 保存 在 应 用 程序 对 象 中 ,那么 可 以 使 用 
下 面 的 代码 来 实现 : 


int count = (int)Application["Count"]; 
count += 1; 
Application["Count"] = count; 


这 段 代 码 看 似 没有 问题 ， 但 是 其 实 它 设计 的 并 不 完美 。 

如 果 有 多 个 用 户 同时 请 求 Web 服务 器 ， 服 务 器 就 打开 了 多 个 线程 ， 同 时 处 理 用 户 的 请 求 。 
当 有 多 个 用 户 ( 比 如 两 个 ) 同 时 执行 到 这 段 代码 时 ， 可 能 同时 先 执 行 了 第 一 行 代码 ， 取 出 了 应 用 
程序 对 象 中 保存 的 统计 信息 的 值 ; 然后 又 同时 执行 了 累加 的 代码 ; 最 后 可 能 又 先后 执行 了 保存 
信息 的 操作 。 这 时 理论 上 Application["Count"] 的 值 应 该 增加 2， 但 是 实际 执行 以 后 ， 
Application["Count"] 的 值 却 只 增加 了 1。 

为 了 解决 这 种 访问 冲突 问题 ，Application 对 象 提供 了 一 种 “加 锁 ” 的 机 制 来 同步 对 应 用 程 
序 状态 的 访问 。 这 个 机 制 通过 Lock0 方 法 和 UnLock0 方 法 来 实现 。 用 户 可 以 把 访问 和 修改 应 用 
程序 的 代码 放 在 Lock0 方 法 和 UnLock0 方 法 调用 之 间 。 这 样 当 一 个 用 户 访 问 应 用 程序 对 象 
Application 时 ， 首 先 使 用 Lock0 方 法 将 Application 对 象 锁定 ， 此 时 其 他 用 户 对 Application 对 
象 的 访问 就 必需 处 于 等 待 状态 ， 直 到 该 用 户 调用 UnLock() 方 法 释放 对 Application 的 锁定 ， 其 
余 的 用 户 才能 进行 访问 。 


Application.Lock(); 


int count = (int)Application["Count"]; 
count += 1; 
Application["Count"] = count; 


Application.UnLock(); 


上 述 代码 解决 了 应 用 程序 的 多 线程 访问 的 问题 ,但 是 在 使 用 这 种 方法 时 , 需要 注意 在 Lock( 
方法 和 UnLock0 方 法 之 间 应 尽 可 能 不 要 做 太 多 工作 。 也 就 是 说 每 一 次 对 Application 对 象 执行 
“加 锁 ” 操 作 的 时 间 段 应 尽 可 能 短 ， 以 提高 应 用 程序 的 性 能 。 
另外 , 还 要 注意 一 点 ， 即 使 用 完 后 必须 对 Application 对 象 进行 解锁 操作 ， 否 则 其 他 请 求 就 
会 一 直 被 阻塞 ， 造 成 程序 假死 。 最 好 的 方法 是 使 用 try-catch-finally 语句 来 管理 该 操作 ， 代 码 
如 下 : 
try 
{ 
Application.Lock(); 
int count = (int)Application["Count"]; 
count += 1; 
Application["Count"] = count; 
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} 

catch 

和 
// 蜡 常 处 理 

| 

finally 
Application.UnLock(); 

| 


这 样 就 能 保证 无 论 中 间 出 现 什么 异常 都 能 够 及 时 地 释放 对 Application 对 象 的 锁定 。 


7.3.2 ”实例 描述 


Application 对 象 可 以 实现 在 应 用 程序 级 的 数据 保存 , 通常 可 以 使 用 它 来 统计 并 记录 当前 系 
统 的 在 线 用 户 数 量 。 

在 本 实例 中 ， 我 们 就 使 用 Application 配合 Web 服务 来 实现 在 线 用 户 数 量 的 功能 ， 并 在 上 
一 节 所 讲解 的 计算 器 窗 体 中 显示 出 来 。 


7.3.3 ”实例 应 用 


【 例 7-2】 使 用 Application 统计 系统 的 在 线 人 数 
(1) 在 Web 服务 项 目 中 添加 一 个 “全 局 应 用 程序 类 ”( 名 为 Globalasax)。 
(2) 在 Globalasax 文件 中 修改 Application Start0 方 法 、Session_Start0 方 法 和 Session_ End 
方法 , 分 别 用 于 初始 化 Application 状态 、 创 建 会 话 时 累加 在 线 人 数 信息 、 会 话 到 期 时 递减 在 线 
人 数 信息 ， 代 码 如 下 : 


protected void Application Start (object sender, EventArgs e) 


/* 如 果 “ 在 线 人 数 ”为 空 ， 将 其 初始 化 为 0 */ 
if (Application["Countonline"] == null) 
{ 
Application["CountOonline"] = 0; 
} 
} 
protected void Session Start(object sender, EventArgs e) 


int countonline = (int)Application["Countonline"]; // 获 得 在 线 人 数 
countonlinet++; // 执 行 累加 
Application["Countonline"] = countOnline; // 设 置 当前 在 线 人 数 


} 


protected void Session End(object sender, EventArgs e) 


{ 


int countonline = (int)Application["Countonline"]; // 获 得 在 线 人 数 
countonline-——; // 执 行 递减 
Application["CountOonline"] = countOonline; // 设 置 当前 在 线 人 数 
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这 样 就 在 Web 服务 器 端 实现 了 统计 活动 Session 个 数 ( 即 在 线 人 数 ) 的 功能 。 

(3) 这 里 需要 在 Web 服务 类 中 添加 Web 服务 方法 ， 用 于 查询 在 线 人 数 ， 代 码 如 下 : 
[WebMethod (EnableSession = true)] 

public int GetCountonline() 

{ 


return (int)Application["Countonline"]; 


} 
(4) 需要 重新 编译 服务 器 端的 Web 服务 项 目 ， 并 在 客户 端 刷 新 该 Web 引用 。 
(5) 在 客户 端 窗 体 中 放 入 一 个 显示 统计 信息 的 Label 标签 lblCount， 以 及 一 个 刷新 在 线 人 
数 的 按钮 btmRefresh， 并 添加 该 按钮 的 单 击 事件 处 理 程序 ， 代 码 如 下 : 
private void btnRefresh Click(object sender, EventArgs e) 
{ 
int count = wsc.GetCountOnline(); 


this.lblCount.Text = count.Tostring(); 


这 样 就 可 以 在 单 击 “ 刷 新 ”按钮 的 时 候 在 窗 体 中 显示 当前 在 线 人 数 。 
7.3.4 ”运行 结果 
运行 Web 服务 项 目 。 然 后 再 运行 客户 端 窗 体 ， 这 时 程序 会 自动 请 求 Web 服务 ， 并 创建 一 


个 Session 对 象 。 然 后 关闭 该 窗 体 ， 重 新 运行 它 ， 程 序 会 再 次 请 求 Web 服务 ,创建 一 个 Session 
对 象 ， 在 窗 体 中 单 击 “ 刷 新 ”按钮 ， 窗 体 中 将 显示 统计 个 数 为 2， 如 图 7-7 所 示 。 


7-7 在线 用 户 个 数 统计 


7.3.5 ”实例 分 析 


nn 


本 实例 ,首先 在 Web 服务 项 目 中 添加 一 个 “全 局 应 用 程序 类 ”, 然后 在 该 类 中 的 Application 
Start() 方 法 里 初始 化 统计 在 线 人 数 的 应 用 程序 状态 。 在 Session Start() 方 法 和 Session End() 方 法 
中 分 别 执行 在 线 人 数 的 更 新 操作 ， 在 Web 服务 中 添加 查询 在 线 人 数 的 Web 方法 。 最 后 在 客户 
端 窗 体 中 刷新 对 该 Web 服务 的 引用 ， 并 调用 该 Web 方法 获取 在 线 人 数 。 
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7.4 在 Web 服务 客户 端 保存 用 户 状 态 


Cookie 提供 了 一 种 在 Web 应 用 程序 中 存储 特定 的 用 户 信 息 的 方法 。 我 们 可 以 将 一 些 用 户 
状态 信息 保存 到 Cookie 中 ,然后 在 客户 端 每 次 请 求 的 时 候 从 Cookie 中 取出 来 进行 相应 的 处 理 。 
下 面 来 介绍 ASP.NET 中 的 Cookie 对 象 。 


入 
EB ! 视频 教学 : 光盘 /videos/07/ 在 客户 端 保存 用 户 状态 .avi 长 度 : 17 分 钟 


7.4.1 基础 知识 一 一 Cookie 对 象 


Cookie 提供 了 一 种 机 制 ， 可 以 在 客户 端 保存 用 户 的 状态 信息 ， 也 可 以 很 方便 地 实现 用 户 状 
态 信息 的 管理 。 


1. 什么 是 Cookie 


Cookie 是 一 段 随 着 用 户 请 求 在 Web 服务 器 和 浏览 器 之 间 传 递 信息 的 文本 。 用 户 每 次 访问 
站 点 时 Web 应 用 程序 都 可 以 读 取 Cookie 里 的 信息 。 
如 果 用 户 访问 某 个 Web 站 点 ， 则 服务 器 返回 给 用 户 的 不 仅 是 一 个 用 户 请 求 的 Web 页面， 
还 有 一 个 包含 日 期 时 间 的 Cookie。 用 户 在 得 到 Cookie 以 后 ， 将 其 存储 在 本 地 硬盘 中 的 临时 文 
件 夹 中 。 以 后 该 用 户 再 次 访问 这 个 Web 站 点 时 ， 这 组 Cookie 信息 会 随 着 用 户 请 求 被 发 送 到 服 
务 器 中 。 服 务 器 接收 到 请 求 并 进行 处 理 ， 然 后 将 处 理 后 的 Web 页 面 和 Cookie 信息 一 起 返回 给 
用 户 。 
客户 端 保存 的 一 组 Cookie 信息 对 应 一 个 Web 站 点 。 因 此 ， 在 访问 某 个 网 站 的 任何 页 面 的 
时 候 ， 都 可 以 读 取 到 同一 组 Cookie 信息 。 
当 用 户 访问 不 同 的 站 点 时 ， 各 站 点 都 会 向 用 户 返 回 一 组 Cookie 信息 ， 用 户 会 分 别 存储 这 
些 Cookie 信息 。 
Cookie 可 以 帮助 Web 站 点 存储 有 关 访 问 者 的 信息 。 一 般 来 说 Cookie 可 以 作为 一 个 客户 端 
; 的 名 片 , 为 Web 服务 器 提供 标识 信息 。 因 此 Cookie 可 以 作为 一 种 保持 Web 应 用 程序 执行 状态 
的 方法 。 
2. 使 用 Cookie 的 限制 


因为 Cookie 支持 在 客户 端 存储 用 户 状态 信息 ， 所 以 客户 端 在 考虑 了 种 种 局 限 性 的 因素 以 
后 ， 对 Cookie 的 使 用 做 出 了 如 下 一 些 限 制 。 

1) “Cookie 大 小 的 限制 

多 数 浏览 器 支持 的 Cookie 最 大 为 4096 字 节 (4KB)。 由 于 这 种 限制 ， 最 好 使 用 Cookie 存储 
少量 的 数据 。 比 如 用 户 ID 或 其 他 身份 标识 符 等。 我 们 可 以 在 服务 器 端 使 用 Cookie 中 的 ID( 或 
其 他 身份 标识 符 ) 来 确定 用 户 ， 并 从 其 他 数据 源 中 读 取 用 户 信息 。 

2) ”Cookie 个 数 的 限制 

浏览 器 一 般 来 说 还 对 Cookie 的 个 数 进行 了 一 些 限制 。 多 数 浏览 器 只 允许 每 个 站 点 存储 20 


m= >> 


第 7 章 管理 Web 服务 的 状态 


个 Cookie， 如 果 存 储 更 多 的 Cookie， 一 些 最 老 的 Cookie 信息 便 会 被 自动 丢弃 。 有 些 浏览 器 还 
会 对 它们 管理 的 Cookie 总 数 做 出 限制 ， 通 常 来 说 都 是 300 个 ， 所 以 也 不 能 在 个 数 上 过 多 地 使 
用 Cookie。 

3) ”浏览 器 禁用 Cookie 

在 客户 端 , 用户 的 浏览 器 可 能 设置 为 禁止 使 用 Cookie。 如 果 用 户 设置 的 安全 级 别 过 高 ,可 
以 通过 一 些 手 段 来 让 用 户 接 收 你 的 Cookie。 而 如 果 用 户 直 接 拒绝 接收 Cookie， 我 们 只 能 放弃 
使 用 Cookie， 而 通过 其 他 一 些 机 制 来 存储 用 户 信息 。 存 储 会 话 状态 可 以 使 用 会 话 ， 但 是 会 话 也 
通常 依赖 于 Cookie( 这 一 点 前 面 我 们 也 介绍 过 了 )。 

虽然 Cookie 在 开发 应 用 程序 中 非常 有 用 ， 但 有 些 应 用 程序 不 应 该 完全 依赖 Cookie 来 实现 
会 话 状态 的 存储 。 

总 之 ， 在 使 用 Cookie 时 ， 需 要 根据 不 同情 况 做 出 不 同 的 设计 。 

3. 使 用 Cookie 


客户 端的 Web 访问 模块 (比如 浏览 器 内 核 ) 负 责 管理 用 户 系统 中 的 Cookie。Cookie 通过 服 
务 器 将 客户 端的 响应 发 送 到 客户 端 , 客户 端 在 执行 Web 请 求 时 将 Cookie 同时 发 送 到 服务 器 中 。 

在 ASPNET 中 ,服务 器 对 客户 端的 响应 使 用 的 是 HttpResponse 对 象 ， 可 以 将 Cookie 信息 
保存 到 HttpResponse 对 象 中 。 服 务 器 接收 客户 端 请 求 使 用 的 是 HttpRequest 对 象 ， 可 以 使 用 
HttpRequest 对 象 获 取 客 户 端 发 送 过 来 的 Cookie 信息 。 

每 个 Cookie 都 必须 有 一 个 唯一 的 名 称 ， 以 便 以 后 读 取 Cookie 时 可 以 根据 名 称 来 识别 它 。 
因为 Cookie 是 按 名 称 存储 ， 所 以 相同 名 称 的 多 个 Cookie 信息 只 会 存储 其 中 的 一 个 。 

在 Web 服务 中 , 所 有 自 定义 的 Web 服务 都 继承 自 System.Web.Services.WebService 类 , 而 
该 类 中 并 没有 直接 使 用 Cookie 的 内 置 对 象 , 也 没有 与 之 相关 的 Request 对 象 和 Response 对 象 。 
但 是 ，System.Web.Services.WebService 类 中 有 一 个 名 为 Context 的 对 象 ， 可 以 使 用 它 来 获取 当 
前 Web 服务 的 上 下 文 对 象 。 然后 使 用 Context 对 象 来 获取 Request 对 象 和 Response 对 象 ， 进 而 
操作 Cookie 集合 。 示 例 代码 如 下 : 


// 写 入 Cookie 
HttpResponse response = Context.Response; // 得 到 Response 对 象 
HttpCookieCollection writeCookies = response.Cookies; // 得 到 cookie 集合 
HttpCookie wCookie = new HttpCookie ("username"); // 创 建 cookie 
wCookie.Value = "admin"; // 设 置 cookie 的 值 
writeCookies.Add (wCookie); // 添 加 cookie 到 集合 中 
// 读 取 cookie 
HttpRequest request = Context.Request; // 得 到 Request 对 象 
HttpCookieCollection readCookies = request.Cookies; // 得 到 cookie 集合 
HttpCookie rCookie = readCookies["username"]; // 获 得 Cookie 
string username = string.Empty; 
if (null != rCookie) // 验 证 取出 的 cookie 是 否 为 空 
E 

username = rCookie.Value; // 获 取 cookie 的 值 


时 


全 5 因为 Request 中 的 Cookie 对 象 中 的 指定 Cookie 可 能 为 空 , 所 以 在 使 用 时 要 进行 非 
注音 | 。 空 验证 ， 以 免 出 错 。 
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上 面 使 用 的 Cookie 是 临时 Cookie, 它 随 浏览 器 的 关闭 而 丢失 .不 过 我 们 还 可 以 设置 Cookie 
的 到 期 时 间 ， 为 Cookie 指定 生命 周期 ， 以 便 Cookie 能 够 永久 保存 。 
这 一 功能 通常 使 用 于 页 面 中 用 户 的 配置 信息 , 或 者 永久 保存 用 户 的 登录 状态 。 比 如 要 设置 
一 个 用 户 登 录 一 次 以 后 永 不 过 期 ， 可 以 将 Cookie 的 到 期 时 间 设 置 得 非常 长 ， 例 如 20 年 或 50 
年 或 者 更 长 。 
》 一般 来 说 ， 还 没有 哪个 Web 系统 可 以 持续 运行 数 十 年 而 不 更 新 或 者 升级 ， 所 以 这 
提示 | 样 就 达到 了 一 个 逻辑 上 的 相对 永久 保存 的 状态 。 另 外 ， 用 户 可 以 随时 清除 其 计算 
机 上 的 Cookie。 即 便 存 储 的 Cookie 距 到 期 日 还 有 很 长 时 间 ， 但 用 户 还 是 可 以 决定 
删除 硬盘 中 的 Cookie， 清 除 Cookie 中 存储 的 所 有 信息 。 


我 们 可 以 通过 设置 Cookie 对 象 的 Expires 属性 来 为 Cookie 对 象 指定 过 期 时 间 ， 示 例 代码 
如 下 : 


HttpResponse response = Context.Response; // 得 到 Response 对 象 


HttpCookieCollection writeCookies = response.Cookies; // 得 到 cookie 集合 
HttpCookie wCookie = new HttpCookie ("username") 7 // 创 建 cookie 
wCookie.Value = "admin"; // 设 置 cookie 的 值 
WwCookie.Expires = new DateTime (2012, 12, 21); 

// 设 置 cookie 到 期 时 间 为 2012 年 12 月 21 日 
writeCookies.Add (wCookie); // 添 加 cookie 到 集合 中 


7.4.2 ”实例 描述 


如 果 要 将 用 户 状态 保存 在 Web 服务 器 端 ， 就 可 以 使 用 ASP.NET 提供 的 Session 对 象 。 如 
果 需 要 在 服务 器 端 节省 内 存 资源 ， 就 可 以 使 用 Cookie 将 用 户 状态 信息 保存 到 客户 端 。 这 样 不 
仅 可 以 节省 用 户 状态 信息 ， 还 可 以 进行 更 加 持久 的 保存 会 话 状态 。 因 为 Cookie 可 以 被 持久 化 
到 客户 端的 硬盘 中 。 

本 实例 ， 我 们 就 使 用 ASP.NET 中 的 Cookie 对 象 来 持久 化 保存 一 个 用 户 的 登录 状态 。 


7.4.3 ”实例 应 用 


【 例 7-3】 在 Web 服务 客户 端 保存 用 户 状 态 
(1) 创建 一 个 提供 发 送 短信 服务 的 Web 服务 ， 名 为 WSMessage。 
(2) 在 WSMessage 中 , 添加 两 个 Web 方法, 分 别 用 于 登录 和 发 送 短 信 的 功能 , 代码 如 下 : 


public class WSMessage : System.Web.Services.WebService 
{ 
[WebMethod] 
public bool Login (string name,string pwd) 
{ 
HttpResponse response = Context.Response; // 获 得 响应 对 象 


} 
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HttpCookieCollection wCookies = response.Cookies; // 获 得 cookie 集合 
HttpCookie ckLoginUser = new HttpCookie ("LoginUser", name); // 创 建 Cookie 
wCookies.Add (ckLoginUser); // 添 加 Cookie 
return true; 
PE 
[WebMethod] 
public string SendMessage (string target, string message) 
{ 
HttpRequest request = Context.Request; 
HttpCookieCollection rCookies = request.Cookies; 
HttpCookie ckLoginUser = rCookies.Get ("LoginUser"); 
if (null == ckLoginUser) 
{ 
return "用 户 验证 失败 ， 请 重新 登录 。"; 
} 
string loginUser = ckLoginUser.Value; 
// 发 送 短信 代码 ( 略 ) 
return "发 送 成 功 ! "; 


在 上 述 代码 中 ， 用 户 登 录 后 并 没有 使 用 Session 来 保存 用 户 的 登录 状态 。 而 是 使 用 Cookie 
将 用 户 状态 保存 到 客户 端 。 这 样 就 可 以 避免 用 户 长 时 间 没有 执行 操作 而 会 话 丢 失 的 问题 。 

(3) 在 窗 体 应 用 程序 中 添加 一 个 关于 该 Web 服务 的 Web 引用 ， 名 为 Message Service。 

(4) 在 我 们 的 发 送 短信 的 应 用 程序 窗 体 中 声明 一 个 关于 WSMessage 的 代理 类 ， 并 初始 化 
它 ， 代 码 如 下 : 


public partial class SendMessage : Form 


{ 
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MessageSerivce.WSMessage wsm = new MessageSerivce.WSMessage(); 
public SendMessage () 
{ 
Wsm.CookieContainer = new System.Net.CookieContainer(); 
InitializeComponent (); 
! 
// 其 他 代码 略 


(5) 创建 一 个 登录 窗 体 ， 其 中 包含 一 个 发 送 短信 的 代理 类 的 类 变量 ， 并 在 构造 方法 中 接收 
一 个 对 象 ， 初 始 化 它 ， 代 码 如 下 : 


public partial class Login : Form 


{ 


MessageSerivce.WSMessage wsm = null; 
public Login (MessageSerivce.WSMessage wsm) 
{ 

this.wsm = wsm; 


InitializeComponent (); 
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UL 
// 其 他 代码 略 
¥ 


(6) 在 登录 窗 体 的 登录 按钮 事件 中 使 用 Web 服务 代理 类 对 象 执行 远程 登录 功能 。 如 果 登 
录 成 功 ， 提 示 用 户 并 关闭 该 窗 体 ， 代 码 如 下 : 


private void btnLogin Click(object sender, EventArgs e) 
{ 
string loginName = this.txtLoginName.Text; 
string password = this.txtPassword.Text; 
if (wsm.Login(loginName,password)) 
{ 
MessageBox .Show ("登录 成 功 ! "); 
this.Close(); 
} 
else 
{ 
MessageBox.Show ("登录 失败 ! "); 
} 
} 


(7) 在 发 送 短信 的 应 用 程序 窗 体 中 执行 登录 命令 时 ， 使 用 对 话 框 的 模式 弹出 登录 窗 体 ， 代 
码 如 下 : 
private void tsmiLogin Click(object sender, EventArgs e) 
E! 
Login loginForm = new Login (wsm) 7 
loginForm.ShowDialog(); 
ba 
(8) 在 发 送 短信 功能 的 代码 中 调用 发 送 短信 功能 的 Web 服务 ， 代 码 如 下 : 
private void btnSend Click(object sender, EventArgs e) 
{ 
string target = this.txtMobile.Text; 
string message = this.txtMessage.Text; 


string result = wsm.SendMessage (target, message); 
MessageBox.Show (result); 


7.4.4 ”运行 结果 


首先 运行 Web 服务 项 目 。 然 后 运行 客户 端 窗 体 应 用 程序 ， 打 开 SendMessage 对 话 框 。 在 
该 对 话 框 中 输入 一 个 手机 号 码 和 一 段 短 信 内 容 ， 单 击 【 发 送 】 按 钮 ， 弹 出 “用 户 验 证 失败 ， 
请 重新 登录 ”的 提示 框 ， 如 图 7-8 所 示 。 
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单 击 【 用 户 登 录 】 菜 单项 ， 在 弹出 的 【登录 】 对 话 框 中 输入 用 户 名 和 密码 (这 里 随意 输入 
就 行 )， 单 击 【 登 录 】 按 钮 ， 系 统 就 会 调用 Web 服务 执行 登录 操作 。 登 录 成 功 以 后 程序 会 弹出 
提示 框 ， 如 图 7-9 所 示 。 单 击 【 确 定 】 按 钮 以 后 会 关闭 【登录 】 对 话 框 。 

接 下 来 在 SendMessage 对 话 框 中 单 击 【 发 送 】 按 钮 ， 系 统 就 会 调用 远 端 Web 服务 ， 并 弹 
出 执行 结果 ， 如 图 7-10 所 示 。 


于 [号码 


短信 和 内容: 


图 7-8 验证 失败 图 7-9 登录 成 功 图 7-10 发送 成 功 


7.4.5 ”实例 分 析 


Cn 


本 实例 ,首先 在 Web 服务 项 目 创建 一 个 提供 发 送 短信 功能 的 Web 服务 。 在 该 Web 服务 中 
创建 两 个 Web 方法 ， 分 别 用 于 执行 登录 功能 和 发 送 短信 的 功能 ， 在 用 户 执行 登录 操作 以 后 ， 
服务 器 将 用 户 的 状态 使 用 Cookie 对 象 保存 到 客户 端 。 然 后 在 客户 端 窗 体 应 用 程序 中 添加 对 该 
Web 服务 的 Web 引用 ， 并 分 别 调用 服务 器 端 创建 的 Web 服务 来 实现 登录 和 发 送 短信 的 功能 。 


7.5.1 在 Web 服务 中 是 否 可 以 保持 客户 端 状 态 


在 Web 服务 中 可 以 保持 客户 端 状态 吗 ? 
网 络 课堂 : http://bbs.itzen.com/thread-15249-1-1.html 
创建 一 个 类 ， 它 的 代码 如 下 所 示 : 


namespace WinFormsApp 
{ 


class Classl 


\! 
public string name; 


public Classl (string n) 
{ 


< 很 一 


name=n; 


} 
} 
public class Servicel : System-Web.Services-WebService 
| 


public Classl c; 
public Servicel() 
{ 
//InitializeComponent (); 
} 
[WebMethod] 
public void Sett() 
{ 
this.c=new Classl( "test ") 7 
} 
[WebMethod] 
public string Gett() 
{ 
return c.name; 


1 


} 


客户 端 在 调用 Sett0 后 再 调用 Gett0 的 时 候 ，c 就 是 null， 如 果 需 要 实现 保持 客户 端的 状态 

功能 ， 应 该 怎么 做 ? 
【解决 办 法 】 

Web 服务 的 私有 成 员 对 于 客户 端 是 没有 用 的 ， 即 在 两 次 调用 过 程 中 ,服务 器 端 会 分 别 创建 
service 对 象 。 所 以 要 使 两 次 调用 能 访问 同一 个 对 象 ， 就 需要 使 用 Session。 首 先 Web Method 需 
要 改动 ， 然 后 客户 端 用 Cookie 来 保持 两 次 操作 在 同一 个 Session 中 。 

例如 : 


//webservice 
[WebMethod (true)] 
public void Sett() 
{ 
Classl c=new Classl( "test "); 
Session[ "MyTest "] = c7 
[WebMethod (true) ] 
public string Gett() 
{ 
Classl c = Session[ "MyTest "] as Classl; 
if(c != nulil) 
return c.name; 
Slse 
return null; 
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7.5.2 ” WebService.asmx 如 何 使 用 Session 


WebService.asmx 如 何 使 用 Session 啊 ? 
网 络 课堂 : http://bbs.itzcn.com/thread-15250-1-1.html 


为 什么 在 Web 服务 里 面 使 用 Session 记录 值 后 ， 在 第 二 次 访问 时 就 自动 消失 了 呢 ? 
【解决 办 法 】 
因为 客户 端 没 有 接收 到 服务 器 回 传 的 Cookie 值 。 因 此 ， 需 要 使 用 一 个 Cookie 容器 接收 服 
务 器 的 Cookie， 也 就 是 设置 代理 类 对 象 的 CookieContainer 属性 。 
Web Server 服务 端 代码 如 下 : 
[WebMethod (EnableSession = true)] 


public void WriteSession(string text) 


{ 


Session["a"] = text; 
} 
[WebMethod (EnableSession = true)] 
public string ReadSession() 
{ 
return Session["a"] .ToString(); 
客户 端 代码 如 下 : 
System.Net .CookieContainer cc = new System.Net.CookieContainer(); 
localhost.WebService ws = new localhost.WebService(); 
ws.CookieContainer = cc; 


ws.WriteSession (TextBox1l.Text) 7 
TextBox2.Text = ws.ReadSession()7 


一 、 填 空 题 


(1) 在 ASP.NET 应 用 程序 中 ， 所 有 Web 服务 的 父 类 System.Web.Services.WebService 中 
的 属性 可 以 获得 当前 会 话 状态 。 


(2) 在 Web 应 用 程序 配置 文件 中 ，system.web 节点 下 的 子 节点 可 以 用 来 设置 
当前 站 点 的 会 话 状态 信息 。 

(3) 在 ASPNET Web 应 用 程序 中 ， 对 象 可 以 在 Web 服务 器 中 共享 一 些 信息 ， 
供 所 有 用 户 请求 使 用 。 

(4) 在 ASPNET Web 应 用 程序 中 ，HttpCookie 类 对 象 的 属性 可 以 设置 这 个 
Cookie 的 生存 周期 。 


< 


二 、 选 择 题 
(1) 会 话 状态 可 以 有 4 个 存储 方式 , 其 中 可 以 将 会 话 存 储 到 另 一 台 服务 器 中 的 
进程 中 。 
A. Inproc B. StateServer C. SqlServer D: Of 
(2) 在 Web 应 用 程序 配置 文件 中 ， 关 于 会 话 的 配置 节点 中 ， 属性 可 以 配置 会 
话 的 生存 周期 。 
A. Mode B. Cookieless C. Timeout D. stateNetworkTimout 


(3) 如 果 要 在 每 一 个 会 话 对 象 创建 的 时 候 初 始 化 会 话 的 状态 信息 ,可 以 在 Global.asax 文件 
中 的 方法 中 添加 初始 化 代码 。 
A. Application _ Start B. Application End 
C. Session Start D. Session End 
三 、 上 机 练习 
上 机 练习 1: 查看 当前 请 求 的 会 话 ID。 
本 练习 要 求 编写 一 个 Web 服务 , 在 该 Web 服务 中 提供 一 个 Web 方法 , 用 于 得 到 当前 浏览 
器 的 会 话 ID。 
需要 注意 的 一 点 是 ， 本 实例 要 求 读者 从 Cookie 中 取出 当前 用 户 的 会 话 ID， 并 返回 给 方法 
调用 者 。 
运行 以 后 ， 在 浏览 器 中 的 效果 如 图 7-11 和 图 7-12 所 示 。 


单 击 此 处 ， 庆 取 完整 的 樟 作 蕊 韦 、 


GetSessionID 
测试 
着 要 使 用 HTTP POST 协议 对 准 作 运行 出 坛 ， 语 单 击 “ 调 用 ” 护 组 


eealheat Sx 


蛮 收 豪 天。 医 http//Aorahost 4s2/ 各 - 园 - 口 虽 ”7 西 四 - 安全- IROV- 全- 


7-12 返回 当前 用 户 的 SessionID 


mm >> 


内 容 摘 要 : 


在 使 用 Web 应 用 程序 时 ,通常 会 因为 网 络 的 问题 而 需要 用 户 进行 漫长 的 等 待 。 同 样 ，Web 
服务 也 不 例外 。 在 前 面 使 用 Web 服务 的 时 候 其 实 就 已 经 深 有 体会 。 
继续 ? 还 是 等 待 ? 这 在 设计 应 用 程序 的 时 候 是 个 问题 。 
实现 异步 化 处 理 ， 是 开发 人 员 在 客户 端 选择 的 一 个 非常 好 的 解决 等 待 问题 的 方案 . 对 Web 
应 用 使 用 异步 化 请 求 的 方案 是 可 行 的 : 在 普通 的 Web 应 用 程序 中 ， 使 用 Ajax 技术 解决 了 很 多 
请 求 过 程 中 没 必要 的 等 待 。.NET 中 的 Web 服务 也 提供 了 异步 调用 的 机 制 ， 可 以 很 轻松 地 实现 
Web 服务 的 异步 化 调用 。 
当 使 用 同步 化 调用 的 时 候 ， 调 用 线程 会 被 阻塞 ， 直 到 调用 结束 。 在 一 些 程序 逻辑 中 ， 同 步 
化 是 必需 的 。 比 如 对 数据 库 的 操作 ， 可 能 需要 较 长 的 时 间 ， 但 是 程序 逻辑 必须 在 获得 数据 以 后 
才能 继续 执行 。 
异步 化 调用 允许 多 个 线程 同时 执行 。 执 行 调 用 以 后 ， 执 行 异 步 化 调用 的 线程 不 会 被 阻塞 。 
因此 ， 在 执行 异步 化 调用 以 后 ， 几 乎 还 可 以 同时 执行 其 他 任何 操作 。 
Web 服务 在 客户 端 应 用 的 时 候 支持 同步 化 调用 和 异步 化 调用 两 种 使 用 方式 , 所 以 可 以 根据 
应 用 程序 的 实际 需求 来 决定 使 用 同步 方式 还 是 异步 方式 调用 Web 服务 。 
在 本 章 ， 我 们 就 来 深入 学 习 基于 ASP NET Web 服务 的 同步 化 调用 和 异步 化 调用 的 主题 。 
在 研究 Web 服务 的 异步 化 调用 时 ， 我 们 也 同时 来 研究 一 下 .NET Framework 是 怎样 为 其 提供 支 
持 的 。 
习 目 标 : 
掌握 异步 化 调用 Web 服务 的 用 法 
掌握 异步 化 调用 执行 的 原理 
了 解 异步 调用 Web 服务 的 回调 方法 
了 解 使 用 Web 服务 要 考虑 的 一 些 问题 
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8.1 Web 服务 的 性 能 测试 


在 使 用 网 络 应 用 程序 进行 数据 同步 时 ， 可 能 会 因为 网 络 问题 而 造成 一 些 延迟 。 可 能 我 们 会 
因为 对 网 络 方面 的 知识 不 了 解 ， 而 对 网 络 延 迟 这 个 概念 没有 很 深 的 印象 。 
在 本 节 ， 我 们 就 来 对 Web 服务 的 性 能 进行 一 个 简单 的 测试 。 


上 视频 教学 光盘/videos/08/Web 服务 的 性 能 测试 avi 人 长 度 : 7 分 钟 
8.1.1 实例 描述 


前 面 我 们 已 经 练习 过 很 多 Web 服务 的 例子 ,也 对 Web 服务 的 使 用 方法 掌握 得 相当 牢固 了 。 
下 面 以 本 书 第 1 章 中 使 用 过 的 一 个 执行 加 法 计算 的 Web 服务 为 例 ， 进 行 一 个 简单 的 测试 。 


8.1.2 ”实例 应 用 


【 例 8-1】 Web 服务 的 性 能 测试 
(1) 创建 一 个 解决 方案 ， 引 入 第 1 章 创 建 的 两 个 项 目 : 一 个 执行 Web 服务 的 Web 项 目 ， 
一 个 使 用 Web 服务 的 控制 台 项 目 。 
(2) 为 了 便于 观察 结果 ， 在 Web 服务 的 服务 器 端 增加 一 个 执行 乘法 的 Web 服务 方法 。 修 
改 后 ， 该 Web 服务 中 的 代码 如 下 所 示 : 


public class Counter : System.Web.Services.WebService 


{ 
[WebMethod] 
public decimal Addl(decimal nl, decimal n2) 
{ 
return nl + n2; 
[WebMethod] 
public decimal Multiply(decimal nl, decimal n2) 
{ 
return nl * n2; 
} 

} 

(3) 保存 以 后 ， 需 要 将 该 项 目 重新 生成 一 下 。 

(4) 在 调用 Web 服务 的 项 目 中 更 新 Web 服务 。 具 体操 作 是 在 该 Web 服务 名 称 
(ServiceCounter) 上 单 击 右键 ,在 弹出 的 快捷 菜单 中 选择 【更 新 服务 引用 】 命 令 。 这 样 就 可 以 在 
客户 端 程序 使 用 该 Web 服务 了 。 

(5) 修改 Program 类 中 的 代码 ， 添 加 新 的 程序 逻辑 ， 并 在 调用 Web 服务 之 前 和 调用 Web 
服务 之 后 输出 当前 时 间 信息 。 代 码 如 下 : 


class Program 


m2 >> 


static void Main(string[] args) 
{ 
ServiceCounter.CounterSoapClient counter = 
new ServiceCounter.CounterSoapClient (); 
Console.Write ("请 输入 一 个 数 : "); 
decimal valuel = decimal.Parse (Console.ReadLine()); 
Console .Write ("请 输入 第 二 个 数 : ") ; 
decimal value2 = decimal.Parse (Console.ReadLine()); 
Console.WriteLine (DateTime .Now); 
Var resultl = counter.Add(valuel, value2); 
Var result2 = counter.Multiply (valuel, value2); 
Console.WriteLine (DateTime.Now); 
var result = resultl == result2; 


Console.WriteLine ("这 两 个 数 的 和 和 这 两 个 数 的 积 ”+ (result ? "相等 " : "不 相 
Console.ReadLine () ; // 程 序 暂停 ， 等 待 用 户 回 车 确认 


代码 输入 完毕 后 ， 执 行 存盘 操作 即 可 执行 该 测试 了 。 
8.1.3 ”运行 结果 


首先 要 运行 Web 服务 的 服务 器 端 项 目 ， 然 后 将 解决 方案 中 的 控制 台 项 目 设置 为 启动 项 目 ， 
并 运行 该 项 目 。 

控制 台 项 目 运行 以 后 ， 分 别 输 入 两 个 十 进 制 数 ， 系 统 会 两 次 调用 Web 服务 ， 并 输出 结果 
以 及 程序 运行 的 当前 时 间 ， 如 图 8-1 所 示 。 


8-1 Web 服务 的 性 能 测试 


从 图 8-1 中 可 以 看 到 ，Web 服务 是 相当 耗费 时 间 的 。 在 这 个 实例 中 ， 只 用 Web 服务 执行 
了 两 次 简单 的 算术 运算 ， 就 足 足 使 用 了 3 秒 钟 的 时 间 。 


8.1.4 实例 分 析 


we 


本 实例 使 用 第 1 章 中 的 一 个 实例 。 首 先 为 其 添加 了 一 个 执行 乘法 运算 的 Web 服务 ， 并 生 
成 项 目 使 其 生效 ; 然后 再 调用 Web 服务 的 客户 端 刷新 对 该 Web 服务 的 引用 ， 并 重新 根据 程序 
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逻辑 修改 调用 Web 服务 的 代码 ; 在 代码 中 ， 分 别 在 调用 Web 服务 时 和 调用 之 后 ， 输 出 系统 的 
当前 时 间 ， 以 便 判 断 Web 服务 的 执行 时 间 。 
据 运 行 结果 分 析 ， 使 用 Web 服务 确实 会 造成 相当 大 的 时 间 延 迟 。 


8.2 ”实现 异步 调用 Web 服务 验证 用 户 注册 信息 


通过 上 一 节 中 的 例子 ， 我 们 知道 在 使 用 Web 服务 时 可 能 会 因为 网 络 的 原因 造成 不 同 程度 
的 延迟 。 如 果 在 这 时 选择 等 待 ， 可 能 会 使 应 用 程序 造成 很 大 的 性 能 浪费 ， 所 以 建议 在 一 些 必要 
的 时 候 使 用 异步 Web 服务 来 提升 应 用 程序 的 性 能 。 

在 .NET 中， 使 用 Web 服务 非常 简单 。 同 样 ， 使 用 异步 服务 也 非常 简单 。 本 节 中 ， 我 们 就 
来 详细 了 解 一 下 在 .NET 中 如 何 开发 使 用 异步 Web 服务 的 应 用 程序 。 


< 视频 教学 : 光盘 /videos/08/ 异 步调 用 Web 服务 .avi 加 长 度 : 13 分 钟 


8.2.1 ”基础 知识 一 一 异步 调用 Web 服务 


一 般 情况 下 ， 当 程序 执行 了 调用 Web 服务 的 语句 后 ， 客 户 端 会 一 直 等 待 Web 服务 执行 完 
成 并 返回 结果 ， 然 后 才 继 续 执行 。 这 样 就 会 造成 客户 端的 线程 一 直 阻塞 ， 从 而 给 用 户 造成 线程 
假死 的 现象 。 这 时 使 用 异步 调用 的 方式 使 用 Web 服务 就 显得 十 分 有 用 了 。 

在 使 用 异步 调用 的 方式 使 用 Web 服务 时 ， 不 会 让 调用 Web 服务 的 客户 端 处 于 阻塞 状态 ， 
从 而 避免 了 线程 假死 的 情况 ， 因 此 可 以 在 调用 Web 服务 的 同时 做 一 些 其 他 的 处 理 。 


$ 如果 要 使 用 Web 服务 ， 不 需要 对 服务 器 端的 Web 服务 特别 设计 。 因 为 Web 服务 

提示 通信 基于 SOAP 消息 交换 ， 所 以 其 在 本 质 上 就 是 异步 的 。 修 改 代理 层 ， 就 可 以 同 
步 或 异步 调用 任何 Web 服务 。 

在 .NET 中 ， 使 用 自动 生成 的 代理 类 包括 了 异步 调用 的 任何 方法 的 基本 特性 。 不 过 在 使 用 


异步 Web 服务 添加 服务 引用 时 需要 进行 一 些 简 单 的 配置 。 具 体操 作 如 下 。 
首先 在 客户 端 程序 中 添加 服务 引用 ， 打 开 【 添 加 服务 引用 】 对 话 框 ， 如 图 8-2 所 示 。 


区 区 
ET 
二 办， 
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8-2 添加 服务 引用 
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在 【添加 服务 引用 】 对 话 框 中 单 击 左 下 角 的 【高 级 】 按钮 ， 打 开 【 服 务 引 用 设置 】 对 话 框 。 
在 【服务 引用 设置 】 对 话 框 中 选中 【生成 异步 操作 】 复 选 框 ， 如 图 8-3 所 示 。 


8-3 添加 引用 设置 


单 击 【 确 定 】 按 钮 关闭 该 对 话 框 。 然 后 在 【添加 服务 引用 】 对 话 框 中 单 击 【 确 定 】 按 钮 即 
可 创建 包含 异步 请 求 配置 的 Web 服务 引用 。 

在 生成 的 代理 类 中 ， 相 对 于 没有 使 用 异步 Web 服务 创建 的 代理 类 而 言 ， 使 用 异步 Web 服 
务 创建 的 代理 类 要 多 出 几 个 方法 。 下 面 我 们 通过 Visual Studio 中 的 对 象 浏览 器 来 查看 这 个 类 中 
的 接口 。 图 8-4 所 示 为 没有 使 用 异步 方式 创建 的 代理 类 的 方法 结构 。 图 8-5 所 示 为 使 用 异步 方 
式 创建 的 代理 类 的 方法 结构 。 


图 8-4 未 使 用 异步 方式 创建 的 代理 类 图 8-5 使 用 异步 方式 创建 的 代理 类 


当然 ， 不 同 的 方式 生成 的 代理 类 的 代码 并 不 相同 。 以 常用 的 几 个 方法 为 例 ， 没 有 使 用 异步 
方式 创建 的 代理 类 代码 如 下 : 
public decimal Add(decimal nl, decimal n2) { 


return base.Channel.Add (nl, n2); 


} 
而 使 用 异步 方法 生成 的 代理 类 的 主要 代码 多 出 来 两 个 方法 ， 如 下 所 示 : 


public decimal Add(decimal nl, decimal n2) { 
return base.Channel.Add(nl, n2); 
} 
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[System.ComponentModel .EditorBrowsableAttribute(System.ComponentModel .Edito 
rBrowsablesState.Advanced)] 
public System.IAsyncResult BeginAdd(decimal nl, decimal n2, 
System.AsyncCallback callback, object asyncstate) { 
return base.Channel.BeginAdd(nl, n2, callback, asyncstate); 
} 


[System.ComponentMode]l .EditorBrowsableAttribute (System.ComponentModel .Edito 
rBrowsableState.Advanced)] 
public decimal EndAdd (System.IAsyncResult result) { 
return base.Channel .EndAdd (result); 
} 


上 面 代码 中 的 第 一 个 方法 和 未 使 用 异步 方式 生成 的 代理 类 的 方法 相同 。 我 们 可 以 使 用 这 个 


方法 调用 Web 服务 并 等 待 返回 结果 。 后 面 两 个 方法 是 为 进行 异步 交互 提供 的 ， 使 用 它们 可 以 
轻松 地 实现 对 Web 服务 的 异步 调用 。 


@ ” 这 里 的 Begin***() 方 法 通常 提供 两 个 额外 的 参数 ,以 Web 服务 中 的 Add 方法 为 例 ， 
注意 除了 Add 方法 需要 的 两 个 decimal 类 的 方法 以 外 ， 它 还 需要 提供 两 个 用 于 同步 的 


参数 。 但 是 与 之 对 应 的 End***() 方 法 通常 只 需要 一 个 参数 。 
这 里 仍然 以 前 面 使 用 过 的 加 法 计算 器 为 例 。 前 面 已 经 添加 了 人 允许 异步 请 求 的 Web 服务 引 


用 。 下 面 直接 修改 客户 端 类 Program 中 的 代码 ， 使 用 异步 方式 请 求 执行 加 法 的 Web 服务 ， 如 
下 所 示 : 


mS > 


class Program 
{ 
static void Main(string[] args) 
{ 
ServiceCounter.CounterSoapClient counter = 
new ServiceCounter.CounterSoapClient (); 
Console.Write ("请 输入 加 数 :"); 
decimal valuel = decimal.Parse (Console.ReadLine()); 
Console .Write ("请 输入 被 加 数 : ") ; 
decimal value2 = decimal.Parse (Console.ReadLine()); 
var result = counter.BeginAdd (valuel, value2, null, null); 
// 执 行 异步 请 求 
Console.WriteLine ("本 地 运行 的 相 加 结果 : " + (valuel + value2)); 
Console.WriteLine ("等 待 Web 服务 请 求 结果 ") ; 
while (!result.IsCompleted) 
{ 
Console.Write(™"."); 
System.Threading.Thread.Sleep(10); 
} 
Console.WriteLine(); // 换 行 
Var Value3 = counter.EndAdd (result); 
Console.WriteLine ("Web 服务 请 求 结果 : " + value3); 
Console.ReadLine (); / /程序 暂停 ， 等 待 用 户 回 车 确认 
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上 面 代码 中 为 了 防止 延迟 过 长 、 输 出 过 多 的 英文 名 号 ,使 用 System.Threading. 
提示 Thread.Sleep(10); 语句 将 当前 线程 每 次 都 延迟 10 毫秒 。 


上 面 代码 执行 以 后 ， 结 果 如 图 8-6 所 示 。 


图 8-6 异步 调用 Web 服务 的 执行 过 程 


8.2.2 ”实例 描述 


微软 发 布 了 一 个 Web 服务 的 典型 应 用 一 一 Passport。 其 实现 思路 是 将 所 有 用 户 信息 作为 一 
个 信息 中 心 保存 在 一 个 提供 Web 服务 的 服务 器 中 ， 用 户 可 以 远程 使 用 这 些 Web 服务 提供 的 接 
口 来 进行 用 户 的 信息 和 权限 的 验证 。 

本 实例 中 ， 使 用 Web 服务 模拟 一 个 用 户 信息 中 心 。 在 另 一 个 Web 系统 中 的 用 户 注册 功能 
实现 过 程 中 使 用 该 Web 服务 完成 用 户 的 注册 。 


8.2.3 ”实例 应 用 


【 例 8-2】 实现 异步 调用 Web 服务 验证 用 户 注册 信 息 
(1) 在 Web 服务 的 Web 项 目 中 创建 一 个 执行 用 户 管理 功能 的 Web 服务 Passport。 
(2) 在 Web 服务 Passport 中 分 别 创建 一 个 验证 用 户 是 否 存 在 的 Web 服务 方法 ， 和 一 个 执 
行 注 册 的 方法 ，Passport 类 的 代码 如 下 : 


public class Passport : System.Web.Services.WebService 
{ 
[WebMethod] 
public bool ValidateUsername (string username) 
{ 
return "admin" == username; 
J】 
[WebMethod] 
public void Register (string username, string password, string realName) 
| 
// 执 行 注册 的 代码 ( 略 ) 
} 
} 


这 里 的 两 个 Web 服务 方法 的 实现 只 是 模拟 了 一 下 相应 的 功能 ， 没 有 具体 的 实现 。 
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(3) 在 客户 端的 Web 项 目 中 添加 对 该 Web 服务 的 引用 。 
(4) 在 用 户 注册 页 面 添加 页 面 结构 ， 主 要 代码 如 下 所 示 : 


<table> 
<tr><td> 用 户 名 : </td><td> 

<asp:TextBox ID="txtUsername"”Iunat="SerVer" 
CssClass="input"></asp:TextBox></td></tr> 
<tr><td> 登 录 密码 : </td><tq> 

<asp:TextBox ID="txtPassword" runat="server" CssClass="input™" 
TextMode="Password"></asp:TextBox></td></tr> 
<tr><tq> 真 实 姓名 : </td><td> 

<asp:TextBox ID="txtRealname" runat="server" 
CssClass="input"></asp:TextBox></td></tr> 
<tr><td colspan="2"> 

<asp:Button ID="btnsave" runat="server" Text=" 注 册 " 
onclick="btnSave Click" /></td></tr> 
<tr><td colspa pe 

<asp:Label ID="]lblError" runat="server" 
ForeColor="Red"></asp:Label></td></tr> 
</table> 


(5) 在 页 面 中 【注册 】 按钮 的 单 击 事件 中 获取 页 面 中 用 户 输入 的 内 容 ， 并 执行 相应 的 验证 
过 程 和 注册 执行 过 程 ， 代 码 如 下 : 


protected void btnSave Click(object sender, EventArgs e) 


string username = this.txtUsername.Text.Trim(); 
string password this.txtPassword.Text.Trim(); 
string realname = this.txtRealname.Text.Trim(); 
ServicePassport.PassportSoapClient passport = 


new ServicePassport.PassportSoapClient (); 
IAsyncResult validateUsername = null; 


if (string.Empty != username) 
{ 
// 开 始 验证 
validateUsername = passport.BeginValidateUsername (username, null, 
null); 
. 
else 
| 


this.1lblError.Text = "用 户 名 不 能 为 空 "; 


return; 
if (string.Empty == password) 


this.1lblError.Text = "密码 不 能 为 空 "; 


return; 


if (string.Empty == realname) 
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this.1lblError.Text = "真实 姓名 不 能 为 空 "; 


return; 
} 
while (!validateUsername.IsCompleted) 


System-Threading-Thread-Sleep(10) 7 


// 结 束 验证 ， 获 取 验 证 结果 
var result = passport.EndValidateUsername (ValidateUsername) ; 
if (result) 


{ 
this.lblError.Text = "用 户 ” + username + "已 存在 "; 


return; 


} 


else 


// 使 用 Web 服务 注册 用 户 信 息 
passport.Register (username, password, realname); 
this.1lblError.Text = "注册 成 功 "; 


} 

在 这 段 代码 中 ， 因 为 考虑 到 在 验证 用 户 名 是 否 存在 时 可 能 需要 较 长 的 时 间 。 所 以 ， 这 里 使 
用 异步 调用 Web 服务 的 方式 验证 用 户 是 否 存在 ， 并 同时 对 用 户 输入 的 其 他 项 目 进行 验证 。 

(6) 保存 项 目 ， 即 可 完成 测试 。 


8.2.4 运行 结果 


首先 运行 Web 服务 项 目 ， 然 后 再 运行 Web 客户 端 项 目 ， 并 访问 用 户 注册 页 面 ， 这 里 访问 
http://localhost:10587/Register.aspx。 

在 用 户 注册 页 面 ， 输 入 用 户 名 、 密 码 和 真实 姓名 ， 然 后 单 击 【注册 】 按 钮 。 程 序 执行 完 信 
息 验 证 ， 在 页 面 中 输出 相应 的 错误 信息 ， 如 图 8-7 所 示 。 


htto eeaater aspr — Windows Internct kxplorer 


8-7 ”用 户 名 验证 失败 


< 人 mm 


换 一 个 用 户 名 (比如 “joker”)， 再 次 单 击 【 注 册 】 按钮 ， 页 面 中 将 提示 “注册 成 功 ”信息 ， 


如 图 8-8 所 示 。 


全 "有 目 口 各 "ED 2 IAO- 生 < 
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图 8-8 注册 成 功 


8.2.5 ”实例 分 析 


a 


本 实例 ， 首 先 在 Web 服务 项 目 中 创建 一 个 用 于 执行 用 户 管理 功能 的 Web 服务 Passport， 
并 为 Passport 添加 两 个 Web 服务 方法 ， 分 别 执行 用 户 名 验证 和 用 户 注册 功能 ; 然后 在 Web 项 
目 中 添加 对 该 Web 服务 的 引用 ， 并 在 页 面 中 使 用 异步 方法 验证 用 户 信息 ， 同 时 执行 对 其 他 输 
入 项 目的 验证 ; 最 后 在 验证 通过 时 使 用 Web 服务 提供 的 注册 方法 执行 用 户 注册 功能 。 


8.3 ”异步 调用 和 同步 调用 的 比较 


虽然 异步 调用 和 同步 调用 在 表面 上 十 分 相似 ， 但 是 用 来 调用 Web 服务 的 内 在 过 程 是 不 


同 的 。 


在 使 用 Web 服务 的 系统 中 ， 客 户 机 调用 的 服务 器 的 方法 被 捆绑 在 SOAP 消息 中 ， 并 通过 
Internet 使 用 HTTP 协议 发 送 到 服务 器 端 。 


网 络 环境 而 产 


由 于 Intemet 固有 的 延迟 特性 ， 使 用 远程 过 程 调用 (RPC) 在 访问 Web 服务 时 会 因为 不 同 的 
生 不 同 的 效果 。 所 以 ， 在 设计 一 些 使 用 Web 服务 的 应 用 时 ， 不 得 不 考虑 一 些 调 


用 方法 选择 的 问题 。 
下 面 就 针对 客户 端 调用 Web 服务 的 这 两 种 方法 进行 比较 ， 来 理解 异步 调用 Web 服务 的 深 


层 运行 机 制 。 


只 视频 教学 : 光盘 /videos/08/ 异 步 和 同步 的 比较 .avi 图 长 度 : 10 分钟 
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异步 调用 Web 服务 的 方式 在 处 理 比 较 复杂 的 业务 逻辑 时 ， 往 往 会 节省 大 量 时 间 ， 比 同步 
调用 Web 服务 更 有 效率 。 这 一 点 ， 在 前 面 两 节 的 实例 中 已 经 有 所 体会 。 

不 过 同步 也 有 同步 的 好 处 ， 比 如 在 处 理 一 些 获 得 结果 才能 继续 执行 的 业务 逻辑 时 ,同步 的 
方式 使 用 更 加 方便 。 

下 面 就 根据 它们 的 执行 原理 进行 一 些 比较 。 


1. 同步 化 调用 Web 服务 


同步 化 操作 由 一 组 前 后 紧 接 的 组 件 或 方法 的 调用 组 成 。 一 个 同步 化 操作 会 阻塞 整个 调用 
Web 服务 的 进程 ， 直 至 Web 服务 调用 结束 ， 下 一 行 操作 才 会 执行 。 

这 种 行为 模式 有 很 多 实例 。 比 如 我 们 对 数据 库 执行 查询 操作 , 可 能 这 个 查询 操作 十 分 复杂 ， 
也 或 许 数 据 库 服 务 器 受 网 络 影响 ， 响 应 速度 较 慢 。 但 是 在 数据 库 服 务 器 返回 结果 之 前 ， 我 们 必 
须 处 于 等 待 状态 。 等 数据 库 查 询 到 相应 的 数据 ， 并 做 出 响应 以 后 ， 调 用 Web 服务 的 客户 端 进 
程 才 会 解除 阻塞 状态 。 同 步调 用 Web 服务 的 执行 原理 如 图 8-9 所 示 。 


8-9 同步 调用 Web 服务 的 执行 原理 


从 图 8-9 中 可 以 看 到 , 同步 调用 的 过 程 只 有 一 条 主线 。 从 调用 ,到 服务 器 执行 并 返回 结果 ， 
是 一 气 呵 成 ， 没 有 分 支 。 

(D 程序 执行 到 调用 Web 服务 的 代码 以 后 ， 操 作 代理 类 ; 

(2) 代理 类 请 求 Web 服务 器 ， 调 用 Web 服务 ， 并 使 该 线程 进入 等 待 状态 ; 

(3) Web 服务 在 接收 到 客户 端的 请 求 以 后 ， 执 行 相 应 的 操作 ， 并 返回 执行 结果 ; 

(4) 代理 类 在 接收 到 Web 服务 的 响应 信息 以 后 ， 解 析 并 将 解析 到 的 数据 返 
用 者 ; 

(5) 主 程 序 接收 到 调用 结果 以 后 ， 继 续 执 行 后 面 的 代码 。 

在 大 多 数 情况 下 ， 同 步调 用 所 产生 的 性 能 损耗 是 可 以 接受 的 ， 但 是 这 样 没有 办 法 保证 在 处 
理 并 发 操作 时 的 额外 系统 开销 。 

2. 异步 化 调用 Web 服务 

异步 化 调用 是 客户 端的 行为 ， 类 似 于 Web 开发 中 的 Ajax 技术 。 

异步 化 调用 的 一 大 特点 就 是 异步 化 操作 不 会 阻塞 启动 调用 操作 的 线程 , 不 影响 调用 线程 的 


< 人 mm 


了 


给 方法 调 


其 他 业务 逻辑 的 执行 。 

不 过 异步 化 调用 的 应 用 程序 必须 通过 反复 检测 代理 类 请 求 Web 服务 的 执行 状态 来 确定 
Web 服务 是 否 执行 完成 。 如 果 执 行 完成 ， 才 可 以 从 代理 类 实例 中 获取 异步 调用 的 执行 结果 。 异 
步调 用 Web 服务 的 执行 原理 如 图 8-10 所 示 。 


交 收 调 
ed sd 


8-10 ”异步 操作 的 执行 原理 


从 图 8-10 可 以 看 到 ， 异 步 操作 也 非常 简单 。 

(1) 应 用 程序 在 代理 类 中 返回 给 调用 者 一 个 操作 句柄 ， 并 同时 调用 Web 服务 ; 

(2) 应 用 程序 在 获得 操作 句柄 以 后 ， 继 续 执 行 其 他 业务 逻辑 ; 

(3) 应 用 程序 在 执行 的 时 候 ， 可 以 不 定时 地 反复 检测 代理 类 异步 请 求 的 状态 ; 

(4) 在 检测 到 异步 请 求 Web 服务 的 操作 完成 后 ， 应 用 程序 线程 就 可 以 操作 代理 类 ， 获 取 
相应 的 执行 结果 ; 

(5) 最 后 应 用 程序 处 理 异步 Web 服务 调用 得 到 的 数据 。 

异步 调用 操作 相对 于 同步 调用 来 说 ， 操 作 稍 微 有 一 点 复杂 。 不 过 ， 在 处 理 一 些 复杂 的 业务 
逻辑 时 ， 合 理 地 使 用 异步 调用 Web 服务 的 方式 为 应 用 程序 带 来 了 性 能 上 的 提升 。 所 以 在 设计 
一 个 应 用 程序 时 ， 使 用 同步 调用 还 是 异步 调用 Web 服务 需要 考虑 应 用 程序 的 实际 需求 。 


3. 何 时 使 用 异步 化 调用 Web 服务 


其 实在 .NET 中， 几乎 所 有 的 方法 调用 都 是 使 用 同步 处 理 的 方式 执行 的 ， 这 样 可 以 很 轻松 
地 避免 异步 方式 调用 产生 的 数据 同步 、 共 享 资源 的 访问 等 问题 。 但 是 ,使 用 异步 的 方式 确实 可 
以 在 很 大 程度 上 解决 程序 性 能 的 问题 ， 这 一 点 是 同步 方式 所 不 具备 的 优势 。 

不 过 在 .NET 中 ， 使 用 最 先进 的 技术 ， 也 可 以 成 功 地 开发 出 一 些 很 完美 的 使 用 异步 化 的 解 
决 方案 。 下 面 来 列举 几 个 需要 使 用 异步 方式 的 情况 。 

@ ”在 开发 Windows 应 用 程序 时 。 如 果 在 Windows 应 用 程序 的 主线 程 中 使 用 同步 方式 调 
用 Web 服务 ， 那 么 在 数秒 之 内 ， 该 Windows 应 用 程序 的 主 窗口 将 处 于 阻塞 状态 ， 给 
用 户 造成 应 用 程序 “假死 ”的 感觉 。 这 个 时 候 ， 使 用 异步 调用 的 方式 可 以 很 轻松 地 避 
免 这 个 问题 。 
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@ 如 果 某 个 Web 服务 的 调用 需要 一 定 的 时 间 来 完成 ， 那 么 使 用 异步 化 调用 的 方式 将 非 
常 有 益 。 这 样 使 用 异步 化 调用 方式 以 后 ， 在 Web 服务 响应 请 求 之 前 ， 还 可 以 做 一 些 
其 他 操作 ， 以 节省 时 间 ， 提 高 应 用 程序 的 性 能 。 

@ 客户 端 程序 需要 同时 调用 多 个 Web 服务 时 ， 使 用 异步 化 调用 的 方式 再 好 不 过 了 。 这 
样 多 个 Web 服务 的 调用 操作 同时 执行 ， 可 能 仅仅 使 用 一 个 调用 的 时 间 ， 就 可 以 完成 
所 有 的 调用 。 

@ ”如 果 Web 服务 的 客户 端 是 一 个 ASP.NET 应 用 程序 ， 使 用 异步 操作 会 是 一 个 不 错 的 方 
案 。 因 为 同步 化 调用 会 导致 线程 阻塞 ， 线 程 阻 塞 以 后 ASP.NET 工作 站 线程 将 会 停止 
运行 。 那 么 ， 在 该 工作 站 下 运行 的 其 他 Web 应 用 程序 也 将 被 同时 阻塞 。 


8.4 异步 用 户 信息 查询 服务 


前 面 我 们 通过 一 些 例子 学 习 了 .NET 下 的 Web 服务 的 异步 调用 的 方法 。 下 面 ， 我 们 将 深入 
研究 NET Framework 中 的 公共 语言 运行 时 (Common Language Runtime，CLR) 是 如 何 为 异步 化 
调用 Web 服务 提供 支持 的 。 


< 视频 教学 : 光盘 /videos/08/ 异 步 用 户 信息 查询 服务 .avi 长度 : 13 分 钟 


8.4.1 基础 知识 一 一 使 用 回调 


对 于 程序 员 来 说 , 编写 一 个 同步 化 的 方法 调用 是 非常 简单 的 事情 , 但 是 编写 异步 化 的 方法 
调用 却 有 些 复杂 。 特 别 是 在 .NET Framework 出 现 以 前 ， 编 写 异步 化 ， 对 程序 员 来 说 简直 就 是 
最 梦 。 

还 好 ，.NET Framework 对 解决 上 述 问 题 提 供 了 基本 支持 。 我 们 可 以 在 .NET 中 轻松 地 实现 
对 Web 服务 的 异步 调用 。 


1. .NET CLR 提供 的 机 制 


.NET Framework 提供 了 功能 强大 的 多 线程 机 制 和 异步 化 的 机 制 ， 可 以 在 .NET 中 很 轻松 地 
实现 异步 化 操作 。 

异步 化 编程 是 NET Framework 中 的 诸多 领域 都 会 用 到 的 一 种 特性 ， 包 括 网 络 通信 、 信 息 
队列 、 异 步 委托 、IO 操作 等 。 

.NET Framework 致力 于 为 异步 化 处 理 提供 一 个 一 致 的 框架 ， 其 提供 了 一 个 通用 的 设计 模 
式 作为 核心 理念 。 该 设计 模式 包含 的 几 个 基本 概念 如 下 。 

@ .NET Framework 为 异步 化 编程 提供 必要 的 服务 。 
在 使 用 异步 化 时 ， 决 定 是 否 使 用 异步 化 方式 的 选择 权 由 客户 端 来 决定 。 
客户 端 可 以 自由 选择 是 否 支持 异步 化 调用 。 
客户 端 没有 必要 为 使 用 异步 化 而 编写 额外 的 代码 。 
CLR 为 异步 化 提供 了 类 型 安全 。 
因为 .NET 中 编写 的 程序 都 要 运行 在 CLR 中 ， 所 以 我 们 在 .NET 中 不 必 为 使 用 异步 化 而 改 
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为 使 用 特定 的 语言 。.NET 中 使 用 的 任意 一 门 语言 ， 都 可 以 使 用 CLR 提供 的 支持 来 编写 异步 化 
功能 。 

2. 认识 回调 

前 面 我 们 演示 过 ， 异 步 化 编程 的 必要 条 件 之 一 就 是 必须 使 调用 线程 知道 异步 请 求 何 时 结 
束 。 当 然 ， 可 以 像 前 面 使 用 过 的 方法 一 样 反 复 检测 异步 请 求 的 状态 来 实现 这 个 功能 。 与 这 种 方 
法 相 比 ， 另 一 种 方法 就 是 使 用 一 个 带 有 回调 方法 的 接收 器 对 象 ， 它 允许 调用 异步 请 求 的 对 象 通 
知客 户 机 应 用 程序 异步 调用 执行 结束 。 这 种 使 用 回调 方法 的 机 制 在 .NET Framework 中 的 具体 
实现 就 是 委托 (delegate)。 

委托 是 对 函数 的 封装 ， 是 一 种 引用 方法 的 类 型 。 一 旦 为 该 委托 分 配方 法 ， 那 么 该 委托 将 与 
该 方法 具有 相同 的 行为 。 

创建 用 来 接收 回调 的 方法 必须 使 用 System.AsyncCallback 委托 定义 的 签名 。 以 本 章 第 2 节 
中 的 实例 ， 执 行 用 户 注 册 验 证 的 异步 回调 功能 来 说 ， 可 以 定义 如 下 回调 方法 : 

public void Callback (IAsyncResult result) 


{ 
} 


@” 由 于 ASPNET WebFom 程序 有 页 面 生存 周期 的 问题 ， 因 此 在 下 面 的 实例 中 将 使 
注意 | 用 WinForm 程序 来 演示 。 


如 果 要 附加 回调 ， 则 需要 创建 一 个 指向 该 回调 方法 的 AsyncCallback 委托 变量 ， 然 后 将 这 
个 变量 传递 给 BeginValidateUsername() 方 法 。 代 码 如 下 : 


if (string.Empty != username) 
{ 
AsyncCallback ac = new AsyncCallback (Callback); 
passport.BeginValidateUsername (username, ac, null); // 开 始 验 证 
} 


else 
{ 
this.lblError.Text = "用 户 名 不 能 为 空 "; 


return; 


|; 


这 个 回调 方法 只 能 接收 结果 ,但 是 它 无 法 知道 这 个 响应 来 自 哪个 请 求 。 所以， 为 了 解决 这 
个 问题 ，NET 允许 在 IAsyncResult.AsyncState 属性 中 发 送 随 结果 对 象 提供 的 额外 信息 。 该 对 象 
是 一 个 Object 类 型 , 所 以 它 能 够 存放 任意 类 型 的 实体 ,我们 可 以 在 使 用 BeginValidateUsername 
方法 时 为 其 最 后 一 个 参数 指定 IAsyncResult.AsyncState 属性 的 值 。 然 后 在 回调 方法 中 获取 这 个 
值 ， 进 行 相应 的 类 型 转换 即 可 使 用 ， 修 改 后 的 代码 如 下 : 


if (string.Empty != username) 
{ 
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AsyncCallback ac = new AsyncCallback (Callback); 
passport.BeginValidateUsername (username, ac, passport); // 开 始 验证 
} 
else 


‘ 
this.lblError.Text = "用 户 名 不 能 为 空 "; 


return; 


} 


然后 可 以 在 回调 方法 中 执行 相应 的 业务 逻辑 ， 代 码 如 下 : 
public void Callback (IAsyncResult handler) 
{ 


ServicePassport.PassportSoapClient passport = 
(ServicePassport .PassportSoapClient)handler.AsyncSstate; 


// 结 束 验证 ， 获 取 验 证 结果 


Var result = passport.EndValidateUsername (handler) 7 
if (result) 


{ 
this.1lblError.Text = "用 户 " + this.txtUsername.Text.Trim() + "已 存在 "; 


return; 
} 
Slse 
{ 
// 使 用 web 服务 注册 用 户 信息 
passport .Register (this.txtUsername .Text.Trim() 
7 this.txtPassword.Text.Trim() 
7 this.txtRealname .Text.TIim() 
) 7 
this.1lblError.Text = "注册 成 功 "> 


} 

这 个 例子 可 以 像 前 面 所 列举 的 那个 注册 信息 的 Web 页 面 一 样 ,请 求 并 异步 访问 Web 服务 。 

不 过 ， 设 计 的 这 个 例子 有 一 个 潜在 的 疏漏 。 因 为 回调 方法 运行 的 线程 和 调用 代码 的 线程 不 
同 ， 所 以 在 设计 应 用 程序 时 还 要 考虑 线程 同步 的 问题 。 关 于 线程 同步 的 问题 ， 并 不 是 三 两 句 话 
就 能 解释 清楚 的 , 所 以 这 里 我 们 不 再 研究 。 要 想 了 解 更 多 的 方法 , 可 以 参考 专门 讲解 线程 的 书 。 


8.4.2 ”实例 描述 


在 ASPNET 应 用 程序 中 使 用 回调 的 方式 处 理 Web 服务 的 异步 调用 是 很 不 明智 的 选择 。 因 
为 往往 Web 服务 调用 返回 结果 之 前 ，ASP.NET 的 页 面 请求 也 过 了 生存 周期 。 在 WinForm 应 用 
程序 中 却 不 存在 这 个 问题 。 
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在 一 个 客户 端的 WinForm 应 用 程序 中 使 用 Web 服务 的 方式 与 服务 器 通信 ， 是 一 个 非常 不 
错 的 选择 。 
实例 将 在 一 个 查询 用 户 信息 的 客户 端 应 用 程序 中 使 用 异步 回调 的 方式 来 查询 用 户 信息 。 


8.4.3 ”实例 应 用 


【 例 8-3】 异步 用 户 信息 查询 服务 

(1) 创建 一 个 查询 用 户 信息 的 Web 服务 ， 名 为 Users。 

(2) 在 Users 中 添加 一 个 执行 查询 操作 的 Web 服务 方法 Find。Find 方法 接收 一 个 用 户 ID 
作为 参数 ， 并 返回 指定 用 户 的 信息 。 代 码 如 下 : 


public class Users : System.Web.Services.WebService 


{ 


[WebMethod] 
public Models.Users Findl(int id) 
{ 
if (2 == id) 
{ 
return new Models.Users() 
| 
ID = 2, 
Name = " 张 月 "， 
Age = 23， 
Email = "zhangyue@zy.com", 
Phone = "13333333333", 
Sex = " 男 "， 
Remark = "清华 大 学 计算 机 2302 届 毕 业 生 " 
}; 
. 


return null; 
上 
这 里 我 们 没有 使 用 数据 库 , 只 是 在 Find 方法 中 模拟 查询 数据 。 如 果 调 用 该 方法 的 参数 为 2， 
则 返回 一 个 用 户 信 息 对 象 ， 否 则 返回 null。 
0@ 》 ”在 该 方法 中 使 用 的 Models.Users 类 只 是 一 个 封装 数据 的 模型 类 ， 其 中 的 代码 并 不 
提示 」 复杂 ， 所 以 这 里 不 再 展示 该 模型 类 的 详细 代码 。 
(3) 在 客户 端的 一 个 Windows 窗 体 应 用 程序 中 ， 添 加 对 该 Web 服务 的 异步 引用 ， 命 名 空 
间 名 称 为 ServiceUsers。 


(4) 在 客户 端 ， 有 一 个 执行 用 户 查 询 功能 的 窗 体 ， 现 在 为 其 【查询 】 按 钮 的 单 击 事件 添加 
异步 查询 用 户 信息 的 代码 ， 如 下 所 示 : 
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private void btnQuery _ Click(object sender, EventArgs e) 
{ 


try { id = int.Parse(this.txtID.Text); } 


MessageBox .Show ("请 输入 一 个 合法 的 用 户 ID! "); 

return; 
} 
ServiceUsers.UsersSoapClient usc = new ServiceUsers.UsersSoapClient (); 
AsyncCallback ac = new AsyncCallback (FindUserCallback); 
usc.BeginFind(id, ac, usc); 


} 


(5) 前 面 , 在 创建 AsyncCallback 类 对 象 时 用 到 了 一 个 回调 方法 FindUserCallback。 该 回 
方法 用 于 执行 异步 Web 服务 请 求 完 成 以 后 的 操作 。 代 码 如 下 : 

public void FindUserCallback (IAsyncResult handler) 

§ 


ServiceUsers.UsersSoapClient usc = 
handler.AsyncState as ServiceUsers.UsersSoapClient; 

ServiceUsers.Users user = usc.EndFind(handler); 

if (null != user) 

{ 
this.txtID.Text = user.ID.TosString(); 
this.txtName.Text = user.Name; 
this.txtAge.Text = user.Age.ToString(); 
this.txtEmail.Text = user.Email; 
this.txtPhone.Text = user.Phone; 
this.txtRemark.Text = user.Remark; 

} 

else 

{ 
MessageBox.Show ("没有 找到 该 用 户 ! "); 


} 
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(6) 当然 ， 这 里 同样 会 面临 线程 间 操 作 共享 数据 的 问题 。 这 里 的 解决 方案 是 在 该 窗 体 的 构 


造 方法 中 设置 CheckForlllegalCrossThreadCalls 属性 值 为 false， 代 码 如 下 : 


public UserForm() 

{ 
CheckForIllegalCrossThreadCalls = false; 
InitializeComponent (); 


这 样 ， 在 执行 多 线程 操作 窗 体 中 的 对 象 时 就 不 再 进行 线程 验证 ， 也 就 避免 了 “线程 间 操 作 


无 效 ” 的 问题 。 
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@ 5 虽然 设置 窗 体 的 CheckForlllegalCrossThreadCalls 属性 会 解决 在 该 窗 体 下 的 多 线程 
二 | 操作 的 问题 ， 但 是 为 了 线程 的 安全 性 ， 一 般 不 建议 使 用 该 方法 解决 多 线程 互 访 的 
问题 。 


8.4.4 ”运行 结果 


首先 运行 Web 服务 项 目 , 然后 运行 客户 端的 窗 体 程序 。 在 编号 文本 框 中 输入 一 个 不 存在 
的 用 户 编号 (比如 3)， 单 击 【 查 询 】 按 钮 ， 将 弹出 “没有 找到 该 用 户 ” 的 提示 框 ， 如 图 8-11 
所 示 。 

在 【编号 】 文 本 框 中 输入 要 查询 的 编号 2， 然 后 单 击 【 查 询 】 按 钮 ， 系 统 将 查询 出 编号 为 
2 的 用 户 信息 ， 并 显示 到 窗 体 中 ， 如 图 8-12 所 示 。 


钠 入 用 户 损 S 兰 击 “查询 " 控 提 获得 指定 用 户 信息 
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再 求学 计算 机 2307 属 印 业 生 
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图 8-11 没有 找到 该 用 户 图 8-12 查看 用 户 信息 


8.4.5 “实例 分 析 


es 


本 实例 ， 首 先 创建 一 个 提供 用 户 信息 查询 服务 的 Web 服务 ， 并 模拟 一 些 查 询 逻 辑 ; 然后 
在 客户 端 添加 对 该 Web 服务 的 引用 ; 为 客户 端 中 的 【查询 用 户 信息 】 窗 体 中 的 【查询 】〗 按 钮 
的 单 击 事件 添加 处 理 程序 ; 接着 编写 一 个 处 理 异 步 查询 用 户 信息 结果 的 回调 方法 ; 最 后 需要 设 
置 窗 体 的 CheckForlllegalCrossThreadCalls 属性 来 解决 多 线程 的 共享 数据 访问 问题 。 


8.5 设计 Web 服务 需要 考虑 的 事项 


在 使 用 Web 服务 时 ， 因 为 访问 Web 应 用 程序 的 一 些 不 可 避免 的 问题 ， 所 以 在 调用 Web 
服务 时 不 得 不 为 一 些 特殊 情况 制定 一 些 处 理 方案 。 
本 节 对 调用 Web 服务 时 的 超时 间 题 的 处 理 进行 研究 。 


cs 视频 教学 : 光盘 /videos/08/ 设 计 Web 服务 的 问题 .avi ©kg: 10 分钟 
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8.5.1 基础 知识 一 一 超时 问题 的 处 理 


因为 Web 应 用 程序 由 于 网 络 原因 有 延迟 的 特性 ， 所 以 在 设计 使 用 Web 服务 的 应 用 程序 时 
需要 考虑 到 因为 网 络 延迟 而 带 来 的 一 些 异常 问题 的 处 理 。 


1. 超时 问题 的 处 理 


当 需 要 在 客户 端 采 用 同步 化 调用 Web 服务 的 模式 ， 并 且 这 个 Web 服务 是 一 个 在 网 络 中 的 
Web 服务 器 时 ， 就 必须 考虑 这 个 客户 端 应 用 程序 怎样 能 够 比较 健壮 地 运行 。 也 就 是 说 要 考虑 到 
客户 机 的 网 速 ， 或 者 Web 服务 器 的 运行 负荷 等 问题 。 

如 果 遇 到 响应 时 间 过 长 的 情况 ,我 们 不 可 能 允许 客户 端 应 用 程序 一 直 处 于 等 待 状态 。 在 遇 
到 服务 器 超时 的 问题 时 ， 可 以 使 用 超时 时 间 来 限定 客户 端 请 求 Web 服务 等 待 的 最 长 时 间 。 使 
用 Visual Studio 生成 的 Web 服务 的 代理 类 中 包含 了 调用 Web 服务 使 用 的 那些 方法 以 外 的 其 他 
方法 和 属性 ，Timeout 属性 就 是 其 中 之 一 。 

Timeout 属性 的 格式 如 下 : 

WebService ws = new WebService(); 

// 设 置 代理 类 请 求 超时 时 间 为 3 秒 

ws.Timeout = 3000; 

Timeout 属性 是 基 类 WebClientProtocol 中 声明 的 属性 ， 经 过 多 层 的 派生 关系 ， 被 包含 到 代 
理 类 中 。 


% 在 NET Framework 4.0 中 , 使 用 一 个 Web 服务 可 以 选择 “添加 Web 引用 ”也 可 以 
注意 | 选择 “添加 服务 引用 ”。 这 里 要 注意 ， 在 使 用 “添加 服务 引用 ”生成 的 代理 类 中 
没有 Timeout 属性 。 所 以 需要 选择 “添加 Web 引用 ”来 引入 一 个 Web 服务 。 
Timeout 属性 指定 了 Web 服务 的 客户 端 在 等 待 同步 化 请 求 Web 服务 的 最 大 超时 时 间 。 该 
属性 的 默认 值 为 -1， 表 示 无 限 大 。 
2. 关闭 请 求 
在 客户 端 应 用 程序 中 使 用 异步 化 的 方式 请 求 Web 服务 时 ， 如 果 回 调 机 制 在 一 定 的 时 间 内 
没有 返回 值 ， 则 必须 考虑 应 用 程序 处 理 这 种 超时 问题 的 方法 。 
我 们 可 以 控制 在 调用 该 操作 时 的 终止 时 间 ， 并 继续 执行 其 他 操作 。 


站 因为 Web 架构 服务 的 特殊 性 ， 所 以 没有 办 法 终止 服务 器 端 Web 服务 方法 的 执行 。 
代理 类 从 ClientBase 类 中 继承 了 两 个 方法 Abort0 和 Close0， 可 以 用 来 结束 该 异步 服务 的 
执行 。 
这 两 个 方法 的 功能 差不多 ,都 可 以 结束 当前 异步 调用 Web 服务 的 操作 。 它们 在 ClientBase 
类 中 的 声明 如 下 : 


// 摘要 : 
// 使 System.ServiceModel.ClientBase<TChannel> 对 象 立即 从 其 当前 状态 转换 到 关闭 状态 。 
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public void Abort () 了 
Ur 
// 摘要 : 
// 使 System.sServiceModel.ClientBase<TChannel> 对 象 从 其 当前 状态 转换 到 关闭 状态 。 


public void Close(); 


\ 


深 | ”这 里 需要 注意 的 是 ， 在 使 用 Close( 方 法 时 可 能 会 执行 失败 而 抛 出 异常。 


8.5.2 ”实例 描述 


本 节 学 习 了 在 使 用 Web 服务 的 过 程 中 遇 到 请 求 超时 的 问题 的 解决 方案 。 我 们 可 以 设置 同 
步 请 求 Web 服务 的 超时 时 间 ， 也 可 以 在 异步 请 求 Web 服务 时 执行 放弃 请 求 的 操作 。 

本 实例 就 以 网 站 管理 系统 的 用 户 登 录 功 能 为 例 ， 简 单 演示 一 下 同步 请 求 Web 服务 的 超时 
时 间 的 设置 方法 。 

前 面 的 章节 中 ， 我 们 在 实现 用 户 注册 功能 的 时 候 使 用 了 一 个 名 为 Passport 的 Web 服务 ， 
所 以 这 里 也 使 用 该 服务 执行 用 户 登录 功能 的 验证 。 


8.5.3 ”实例 应 用 


【 例 8-4】 访问 网 络 中 的 Web 服务 
(1) 在 前 面 创建 的 Web 服务 Passport 中 创建 一 个 接收 登录 信息 验证 的 Web 方法 ， 代 码 
如 下 : 
[WebMethod] 
public bool Login (string username,string password) 
{ 
System.Threading.Thread.Sleep(10000); 
return true; 


} 

这 里 在 进行 登录 验证 的 时 候 ， 让 应 用 程序 请 求 暂停 10 秒 钟 。 

(2) 在 客户 端 应 用 程序 中 添加 Web 引用 , 引用 目标 为 前 面 创建 的 Web 服务 Passport, Web 
服务 的 引用 名 称 为 Services.Passport。 

(3) 在 客户 端 应 用 程序 的 登录 页 面 Login.aspx 中 , 为 【登录 】 按钮 添加 单 击 事件 处 理 程序 ， 
代码 如 下 : 


protected void imgbtnLogin Click(object sender, ImageClickEventArgs e) 
{ 


WebService.Passport.Passport passport = new 
WebService.Passport.Passport (); 

passport.Timeout = 3000; // 设 置 延迟 等 待 时 间 为 3 秒 

bool loginResult = false; 

CR 

{ 
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loginResult = passport.Login(this.txtLoginName.Text, this.txtPassword. 
Text); 
} 
catch 
1 
ScriptManager-RegisterStartupScript (this, this.GetType(), "", "alert 
("Web 服务 请 求 超时 ! ')"，true); 
return; 
} 
if (loginResult) 
{ 
ScriptManager.RegisterStartupScript (this, this.GetType(), "", "alert(' 
账户 验证 成 功 ! ')"，true); 
上. 
else 
{ 
ScriptManager.RegisterstartupSscript (this, this.GetType(), "", "alert(' 


账户 验证 失败 ! ')"，true); 
} 


在 创建 代理 类 对 象 时 设置 其 最 大 等 待 的 延迟 时 间 ， 在 这 里 设置 Timeout 属性 的 值 为 3000， 
即 3 秒 钟 。 如 果 验 证 超时 ， 系 统 将 会 弹出 “请 求 超时 ”的 提示 信息 。 


8.5.4 ”运行 结果 


首先 ， 运 行 Web 服务 所 在 的 Web 项 目 。 

然后 ， 访 问 客户 端的 登录 页 面 ， 分 别 在 【用 户 】 和 【密码 】 文 本 框 中 输入 一 些 文本 (这 里 
只 为 测试 ， 所 以 没有 进行 实际 的 验证 )， 然 后 单 击 【 登 录 】 按 钮 ， 执 行 登录 请 求 。Web 页 面 在 
等 待 3 秒 钟 以 后 ， 将 认为 验证 登录 信息 的 Web 服务 请 求 超时 ， 就 会 弹出 “请 求 超时 ”的 提示 
框 ， 如 图 8-13 所 示 。 
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8-13 ”Web 服务 请 求 超时 
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8.5.5 ”实例 分 析 


CO 


本 实例 首先 要 在 提供 登录 验证 的 Web 服务 Passport 中 添加 一 个 执行 登录 验证 的 Web 方法 
Login， 并 在 该 方法 执行 时 延迟 10 秒 钟 ; 然后 在 客户 端 中 添加 关于 该 Web 服务 的 Web 引用 ; 
在 客户 端 登录 页 面 中 的 【和 登录】 按钮 的 单 击 事件 中 添加 验证 的 业务 逻辑 ; 接着， 创建 代理 类 对 
象 ， 使 用 Timeout 属性 设置 请 求 延迟 为 3 秒 钟 ; 最 后 使 用 同步 方式 调用 Web 服务 时 ， 该 请 求 
将 最 多 等 待 3 秒 钟 就 结束 请 求 。 


8.6 常见 问题 解答 


8.6.1 .NET 中 Web 服务 是 同步 调用 还 是 异步 调用 


.NET 中 Web 服务 是 同步 调用 还 是 异步 调用 ? 
网 络 课堂 : http:/Wbbs.itzcn.comythread-15200-1-1.html 

.NET 中 Web 服务 是 同步 调用 还 是 异步 调用 ? 谁 能 给 我 说 说 它们 的 区 别 。 

【解决 办 法 】 

在 .NET 中 调用 Web 服务 ， 可 以 使 用 同步 方式 ， 也 可 以 使 用 异步 方式 。 同 步 就 是 一 次 执行 
完了 ， 异 步 就 是 多 个 执行 动作 是 分 开 的。 两 种 方式 可 以 由 用 户 自由 选择 ， 根 据 实际 情况 来 决定 
使 用 那 种 方式 。 


8.6.2 ”关于 Web 服务 异步 回调 的 问题 


关于 Web 服务 异步 回调 的 问题 。 
网 络 课堂 : http://bbs.itzcn.com/thread-15201-1-1.html 


我 在 Web 服务 中 写 了 一 个 返回 DataSet 的 方法 。 在 Client 端 用 异步 回调 的 方法 在 DataGrid 
中 显示 该 DataSet 中 的 数据 。 数 据 取出 来 了 ， 但 总 是 绑 定 不 到 DataGrid 中 。 如 果 不 是 异步 ， 而 
是 同步 的 话 是 可 以 的 。 同 样 对 于 DataSet 绑 定 方法 ， 同 步 能 够 显示 ， 而 异步 就 不 能 显示 了 ， 有 
没有 人 遇 到 跟 我 同样 的 问题 啊 ? 

【解决 办 法 】 

这 里 有 个 区 别 : 主线 程 和 后 台 线 程 。 主 线程 和 UI 有 关 ， 用 来 刷新 页 面 和 绑 定 数据 。 而 异 
步调 用 是 后 台 线 程 ， 它 无 法 刷新 页 面 和 数据 源 。 

这 里 需要 做 一 些 特殊 的 处 理 。 在 回调 方法 中 ， 需 要 用 当前 Form 实例 的 Invoke 调用 一 个 委 
托 ， 在 该 委托 方法 中 设置 DataGrid 的 DataSource。 


mi > 
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一 、 填 空 题 
(1) 在 客户 端 项 目 中 添加 服务 引用 时 ,需要 在 【服务 引用 设置 〗 对 话 框 中 选中 
单 选 按钮 ， 可 以 添加 支持 异步 调用 的 服务 引用 .。 
(2) 如 果 Web 服务 中 有 一 个 名 为 Insert 的 Web 服务 方法 ， 那 么 在 客户 端 添加 异步 服务 引 
用 以 后 ， 可 以 使 用 代理 类 对 象 的 方法 来 启动 对 该 Web 服务 方法 的 异步 调用 。 
(3) 代理 类 对 象 在 使 用 自动 生成 的 方法 以 异步 方式 调用 一 个 Web 服务 时 ， 该 方法 会 返回 
二 水 类 的 对 象 。 
二 、 选 择 题 
(1) 使 用 回调 的 方式 异步 调用 一 个 名 为 List 的 Web 服务 方法 时 ， 需 要 使 用 类 
封装 一 个 回调 方法 ， 并 作为 参数 传递 给 BeginList 方法 。 
A. System.Web.AsyncCallback 
B. System.Web.Callback 
C. System.AsyncCallback 
D. System.Callback 
(2) 在 使 用 异步 方式 调用 Web 服务 时 , I[AsyncResult 类 的 对 象 可 以 使 用 方法 获 
取 当 前 请 求 的 执行 状态 。 
A. Completed 
B. IsCompleted 
C. Over 
D. IsOver 
(3) 在 使 用 同步 方式 请 求 Web 服务 时 ， 为 了 防止 使 用 Web 服务 过 程 中 的 请 求 耗 时 太 长 而 
影响 应 用 程序 的 执行 效率 ,可 以 设置 该 代理 类 对 象 的 属性 来 为 其 指定 一 个 过 期 时 间 。 
A. TimeOver 
B. OverTime 
C. Time 
D. Timeout 


三 、 上 机 练习 


上 机 练习 1: 使 用 回调 方式 获取 Web 服务 中 的 用 户 列表 信息 。 

本 章 已 经 对 Web 服务 的 异步 调用 的 方式 进行 了 比较 详细 的 了 解 。 在 Windows 窗 体 应 用 程 
序 中 ， 使 用 异步 回调 的 方式 请 求 Web 服务 是 一 种 很 好 的 解决 方案 。 这 样 可 使 程序 逻辑 更 加 清 
晰 合理 ， 也 提高 了 应 用 程序 的 执行 性 能 。 

本 练习 中 就 使 用 异步 回调 的 方式 请 求 Web 服务 ， 获 取 一 个 用 户 信 息 的 列表 ， 并 显示 到 窗 
体 中 。 


< 人 mm 


,df 8 
为 了 更 加 人 性 化 地 提示 用 户 等 待 ,在 窗 体 中 使 用 每 秒 钟 刷 新 的 耗 时 时 间 来 提高 应 用 程序 界 


面 的 友好 性 。 
图 8-14 是 该 应 用 程序 的 执行 结果 。 
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图 8-14 用 户 信息 列表 
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内 容 摘 要 : 

借助 于 ASP.NET 强大 的 功能 ， 开 发 人 员 创 建 Web 服务 也 变 得 很 容易 ， 而 且 在 Web 服务 
中 可 以 集成 ASP.NET 的 大 部 分 功能 。 例 如 ， 在 第 7 章 介 绍 了 Session 和 Application 在 Web 服 
务 中 的 应 用 。 

本 章 将 讨论 如 何 为 Web 服务 添加 缓存 和 事务 功能 。 这 两 个 方面 在 Web 开发 时 最 容易 被 忽 
略 。 我 们 总 是 在 完成 了 项 目的 其 他 方面 之 后 才 会 想到 它们 ， 而 不 是 从 一 开始 就 考虑 。 相 反 ， 如 
果 缓存 和 事务 在 项 目 中 的 应 用 恰到好处 ,那么 会 大 大 提高 代码 的 性 能 ， 避 开 性 能 瓶颈 ， 并 且 使 
Web 服务 具有 可 伸缩 性 。 

学 习 目 标 : 

@ 了 解 ASPNET 的 缓存 机 制 
掌握 如 何 为 Web 服务 启用 输出 缓存 
掌握 应 用 程序 缓存 的 使 用 方法 
熟悉 Cache 对 象 的 操作 
了 解 如 何 设置 缓存 项 的 过 期 和 依赖 性 
掌握 回调 函数 的 使 用 
了 解 事务 的 概念 及 在 Web 服务 中 的 应 用 


9.1 了 解 ASP.NET 缓存 机 制 


所 谓 缓存 ， 就 是 指 在 内 存 中 暂时 保存 一 些 经 常 使 用 的 数据 。 这 样 当下 次 请 求 这 些 数据 时 ， 
就 可 以 直接 从 内 存 中 获取 它们 ， 而 不 用 重复 执行 产生 这 些 数 据 的 操作 ， 因 而 可 以 有 效 地 提高 应 
用 程序 的 性 能 。 

在 ASPNET 中 ， 开 发 人 员 可 以 通过 多 种 方式 来 实现 缓存 功能 。 例 如 ， 可 以 把 一 些 重复 使 
用 的 数据 保存 在 Application 对 象 中 ， 或 者 使 用 专门 的 缓存 对 象 来 保存 等 。 


< 视频 教学 : 光盘 /videos/09/ 了 解 ASPNET 缓存 机 制 .avi 人 @@ 长 度 : 4 分 钟 


为 了 提高 应 用 程序 的 性 能 ，ASP.NET 使 用 两 种 基本 的 缓存 机 制 来 提供 缓存 功能 。 第 一 种 
是 输出 缓存 ， 即 保存 对 页 面 的 输出 ， 并 在 用 户 再 次 请 求 时 ， 重 用 所 保存 的 输出 ， 而 不 是 再 次 处 
理 该 页 面 。 第 二 种 机 制 是 应 用 程序 缓存 ， 它 可 以 缓存 所 生成 的 任何 数据 ， 如 DataSet 或 自 定义 
报表 业务 对 象 。 

下 面 来 详细 了 解 一 下 ASP.NET 的 这 两 种 机 制 。 


1. 输出 缓存 


输出 缓存 是 指 在 内 存 中 存储 处 理 后 的 ASPNET 页 面 内 容 。 这 一 机 制 允 许 ASP.NET 向 客户 
端 发 送 页 面 响应 ， 而 不 必 再 次 经 过 页 面 生命 周期 。 

输出 缓存 对 于 那些 不 经 常 更 改 , 但 需要 大 量 处 理 才 能 创建 的 页 面 特别 有 用 。 例 如 ， 如 果 创 
建 需要 频繁 更 新 数据 的 页 面 时 ， 输 出 缓存 可 以 极 大 地 提高 该 页 的 性 能 。 

如 图 9-1 所 示 为 ASP.NET 输出 缓存 的 执行 流程 。 


Web 方 法 调用 


、 _ Web 服 务 
客户 端 Web 方 法 响应 ASPNET 


应 用 程序 缓存 


返回 缓存 的 Web 方 法 响应 


9-1 输出 缓存 执行 流程 


ASPNET 和 输出 缓存 又 提供 了 两 种 缓存 模型 : 整 页 缓存 和 部 分 页 缓存 。 整 页 缓存 允许 将 页 
面 的 全 部 内 容 保存 在 内 存 中 ， 并 用 于 完成 客户 端 请 求 。 部 分 页 缓存 允许 缓存 页 面 的 部 分 内 容 ， 
其 他 部 分 则 为 动态 内 容 。 

2. 应 用 程序 缓存 

应 用 程序 缓存 为 开发 人 员 提供 了 一 种 以 编程 方式 控制 缓存 的 机 制 ， 它 通过 “ 键 / 值 ”可 以 
将 任意 数据 存储 在 内 存 中 。 

使 用 应 用 程序 缓存 的 流程 是 ， 在 访问 某 一 项 时 判断 该 项 是 否 存在 于 缓存 中 ， 如 果 存 在 ， 则 
使 用 。 如 果 该 项 不 存在 ， 则 可 以 重新 创建 该 项 ， 然 后 将 其 放 回 缓存 中 。 这 一 过 程 可 确保 缓存 中 
始终 有 最 新 的 数据 。 

如 图 9-2 所 示 为 ASP.NET 应 用 程序 缓存 的 执行 流程 。 


ASPNET 


Web 服 务 缓存 


应 用 程序 Web 方 法 响应 | 


重建 缓存 项 


图 9-2 应 用 程序 缓存 执行 流程 


使 用 应 用 程序 缓存 的 优点 是 由 ASP.NET 管理 缓存 ， 它 会 在 过 期 、 无 效 或 内 存 不 足 时 移 除 
缓存 中 的 项 。 还 可 以 配置 应 用 程序 缓存 ， 以 便 在 移 除 项 时 通知 应 用 程序 。 


9.2 ”使 用 输出 缓存 保存 文件 内 容 


通过 使 用 输出 缓存 ， 可 以 把 为 某 个 特定 页 面 建立 的 响应 暂 存 起 来 ， 当 ASP.NET 接收 到 该 
页 面 的 后 续 请 求 时 ， 就 可 以 直接 返回 响应 ， 而 不 用 再 去 执行 ASPNET。 

在 Web 服务 中 使 用 输出 缓存 的 方法 非常 简单 ， 只 需 为 Web 服务 方法 添加 CacheDuration 
即 可 ， 下 面 来 详细 了 解 一 下 吧 。 


上 视频 教学 ;光盘 /videos/09/ 使 用 缓存 保存 文件 avi 人 @@ 基 度 : 1 分 名 


9.2.1 基础 知识 一 一 使 用 输出 缓存 


如 果 要 使 一 个 Web 服务 方法 可 以 使 用 输出 缓存 ， 所 需 的 工作 仅仅 是 为 WebMethod 添加 
CacheDuration 选项 。CacheDuration 的 值 是 一 个 整数 ， 以 秒 为 单位 ， 用 于 指定 缓存 的 有 效 期 限 。 
即 在 这 个 期 限 内 输出 缓存 一 直 有 效 ， 超 过 该 期 限时 将 重新 执行 生成 新 的 输出 缓存 。 

输出 缓存 的 一 个 最 典型 示例 就 是 创建 一 个 Web 服务 方法 返回 当前 时 间 。 假 设 这 个 方法 的 
代码 如 下 所 示 : 


< 人 mm 


[WebMethod (Description = "测试 RsP-NET 的 输出 缓存 。\n 输出 调用 时 的 时 间 ， 结 果 将 缓存 
30 秒 。", CacheDuration=30) ] 
public string OutputCcache () 
{ 
return "你 访问 的 时 间 是 : " + DateTime.Now.Tostring(); 
} 
在 第 一 次 请 求 OutputCache0 方 法 时 ,方法 内 的 代码 会 执行 ,并 返回 包含 当前 时 间 的 字符 串 。 
此 时 ， 该 字符 串 将 在 内 存 中 保存 30 秒 ，30 秒 内 再 次 请 求 OutputCache() 方 法 时 将 直接 输出 该 字 
符 串 ， 而 不 会 重新 获取 时 间 ; 当 超 过 30 秒 时 ， 将 产生 新 的 输出 缓存 。 


\ 
入 ?| 也 可 以 在 Web 服务 的 asmx 文件 中 通过 OutputCache 属性 来 启用 输出 缓存 ， 


例如 ， 在 一 个 ASPNET 项 目 中 引用 OutputCache0 方 法 所 在 的 Web 服务 ， 引 用 名 称 为 
“localhost”; 然后 通过 如 下 的 代码 来 测试 OutputCache0 方 法 : 


protected void Page Load(object sender, EventArgs e) 
f 
// 页 面 加 载 完 成 后 调用 
localhost.Servicel ts = new localhost.Servicel(); 
string strTimel=ts .OutputCache ()7 
Response.Write(" 第 1 次 调用 outputcache () 方 法 的 结果 : <br/>" + strTimel); 
// 等 待 10 秒 后 调用 
System.Threading.Thread.Sleep(10000); 
string strTime2 = ts.OutputCache () 7 
Response.Write ("<hr/>10 秒 后 调用 outputcache () 方 法 的 结果 : <br/>" + strTime2); 
/ /等待 30 秒 后 调用 
System.Threading.Thread.Sleep(30000); 
string strTime3 = ts.OutputCache(); 
Response.Write ("<hr/>30 秒 后 调用 outputcache () 方 法 的 结果 : <br/>" + strTime3); 
} 


由 于 OutputCache() 方 法 会 将 结果 缓存 30 秒 ， 所 以 上 述 代 码 中 strTimel 和 strTime2 的 值 是 
相同 的 。 最 后 一 次 调用 时 ， 已 经 距 结果 产生 有 40 秒 了 ， 所 以 此 时 缓存 将 过 期 ， 重 新 执行 
OutputCache() 方 法 将 结果 保存 到 strTime3 中 。 


10 和 后 调用 OutputC: 
你 访问 的 时 间 是 ，201 


30 入 后 调用 OutpatC: 
你 访问 的 对 则 是 ，2011-3- 


图 9-3 输出 缓存 运行 结果 


m= 地 > 
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通过 上 面 简单 的 示例 可 以 看 出 ， 在 使 用 Web 服务 的 输出 缓存 时 ， 我 们 实际 上 并 不 需 将 任 
何 缓存 代码 插入 Web 服务 方法 本 身 。 仅 仅 是 添加 一 个 CacheDuration 选项 ， 剩 下 的 工作 由 
ASPNET 自动 完成 并 管理 输出 缓存 。 


9.2.2 ”实例 描述 


最 近 接手 了 一 个 项 目 ， 需 求 不 复杂 ， 但 是 对 响应 速度 有 比较 高 的 要 求 。 因 此 ， 在 开发 时 就 
针对 程序 编码 、 数 据 库 设计 和 系统 架构 等 方面 进行 了 特别 的 优化 处 理 。 
另外 , 客户 希望 具有 比较 高 的 跨 平 台 和 伸缩 性 。 对 于 这 一 点 , 我 们 准备 使 用 ASP.NET Web 
服务 来 做 。 至 于 要 提高 响应 速度 ， 没 有 比 缓存 更 合适 的 了 。 
下 面 就 以 此 项 目 为 例 ， 介 绍 Web 服务 缓存 在 项 目 中 的 具体 应 用 。 希 望 能 对 大 家 有 所 帮助 。 


9.2.3 ”实例 应 用 


【 例 9-1】 使 用 输出 缓存 保存 文件 内 容 
(1) 创建 一 个 Web 服务 项 目 ， 并 添加 一 个 名 为 “Servicel.asmx” 的 文件 。 
(2) 在 项 目 中 要 对 文件 进行 操作 ， 所 以 这 一 步 先 添加 下 面 的 引用 。 


using SYstem.IO7 


(3) 编写 读 取 文件 内 容 的 Web 服务 方法 ， 该 方法 接受 要 读 取 的 文件 路 径 ， 并 返回 一 个 自 
定义 的 文件 实例 。 实 现代 码 如 下 : 
[WebMethod (Description=" 读 取 指 定 路 径 的 文件 内 容 ， 并 缓存 10 分 钟 。"， 


CacheDuration=600)] 
public Files getFileContent (string filePath) 
‘ 
Files f = new Files(); 
if (File.Exists(filePath)) // 判 断 文件 是 否 存在 
{ 
FileInfo info = new FileInfo(filePath) // 获 取 文 件 信息 
f.FileName = info.Name; 
f.ExtendName = info.Extension; 
f.LastWriteTime = info.LastWriteTime; 
f.Length = info.Length; 
StreamReader rdFile = new StreamReader (filePath, 
System.Text .Encoding.Default); 


string content = rdFile.ReadToEnd(); // 获 取 内 容 
rdFile.Close(); // 关 闭 文件 
f.FileContent = content; // 保 存 内 容 

1 

return f; // 返 回 文件 实例 


055 


Eee >> 


在 上 述 代码 中 设置 CacheDuration 的 值 为 600,， 即 表示 缓存 10 分 钟 。filePath 为 一 个 文件 的 
路 径 ， 程 序 先 判断 该 文件 是 否 存在 ， 如 果 存 在 则 获取 文件 的 内 容 ， 并 最 终 返 回 。 

(4) 上 一 步 创 建 的 getFileContent0 方 法 返回 为 一 个 Files 类 的 实例 。 该 类 是 我 们 创建 的 自 
定义 类 ， 它 的 声明 及 包含 的 成 员 如 下 : 

public class Files 


‘ 


public string FileName; // 文 件 名 称 
public string ExtendName; // 文 件 扩展 名 
public DateTime LastWriteTime; // 上 次 修改 时 间 
public string FileContent; // 文 件 内 容 
public long Length; // 文 件 大 小 


} 


(5) 至 此 ，Web 服务 的 代码 就 完成 了 ， 是 不 是 很 简单 啊 。 下 面 创建 一 个 ASP.NET Web 项 
目 对 它 进行 调用 。 对 ASPX 页 面 进行 简单 的 修饰 ， 如 下 所 示 是 与 文件 显示 有 关 的 布局 ， 把 它 放 
在 页 面 的 合适 位 置 。 
<div class="contentarea"> 
<hl><asp:Literal ID="ltName" runat="server"/></hl> 
<h2> 扩 展 名 : <asp:Literal ID="1ltExt" runat="server"/> | 文件 大 小 : <asp:Literal 


ID="ltLength" runat="server"/> 字 节 | 上 次 修改 时 间 : <asp:Literal ID="ltTime" 
runat="server"/></h2> 


<p> 
<asp:Literal ID="ltContent" runat="server"/> 
</p> 

</div> 


(6) 添加 对 Servicel.asmx 的 Web 引用 ， 引 用 的 名 称 为 “localhost”。 

(7) 进入 页 面 的 Page_ Load() 方 法 ,编写 代码 通过 localhost 调用 Web 服务 的 getFileContent() 
方法 。 然 后 根据 getFileContent0 方 法 的 返回 结果 在 页 面 上 显示 所 需 的 信息 , 最 终 代码 如 下 所 示 : 

protected void Page_Load (object sender, EventArgs e) 


{ 
localhost.Servicel s = new localhost.Servicel(); // 实 例 化 Web 服务 类 


localhost.Files f = new localhost.Files(); // 实 例 化 Files 类 
string fileURL = Server.MapPath ("story.txt"); // 指 定 一 个 文件 的 完整 路 径 
f = s.getFileContent (fileURL); // 调 用 getFileContent () 方 法 
ltContent.Text = f.FileContent; // 文 件 内 容 

1tExt.Text = f.ExtendName; // 文 件 扩 展 名 

ltLength.Text = f.Length.Tostring(); // 文 件 大 小 

ltName.Text = f.FileName; // 文 件 名 称 


ltTime.Text = f.LastWriteTime.ToSstring ("yyyy-MM-dd");  // 文 件 上 次 修改 时 间 
其 


(8) 保存 上 述 对 页 面 所 做 的 修改 ， 完 成 实例 的 制作 。 
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9.2.4 ”运行 结果 


首先 通过 浏览 器 执行 Web 服务 文件 Servicel.asmx， 并 调用 getFileContent0 方 法 查看 返回 
的 结果 ， 如 图 9-4 所 示 。 


全 目 名 ”7 林口 - 去 和 四- 工具- 性- 


ona/ 2001 /YON Schome ntome 
/2001/ XML Schema" smins= a/ ftompert org /> 


22 与 下 各 
rr pe 
起 单 ， 民 交合 名 到 服务 吕 并 与 入 娄 所 库 。<F 扣 Content> 


9-4 测试 getFileContent() 方 法 


从 图 9-4 所 示 的 结果 中 ， 可 以 看 到 getFileContent0 方 法 能 够 返回 指定 文件 的 信息 。 下 面 通 
过 执行 ASP.NET 页 面 来 测试 ， 运 行 效果 如 图 9-5 所 示 。 


图 9-5 查看 文件 内 容 


9.2.5 ”实例 分 析 


Bs 


本 实例 我 们 针对 缓存 需求 ， 在 Web 服务 的 方法 中 通过 CacheDuration 选项 设置 缓存 为 600 
秒 ， 即 10 分 钟 。 之 后 对 于 缓存 便 不 需要 更 多 的 控制 ， 完 全 由 ASPNET 来 管理 。 

实例 运行 后 ， 可 对 Story.txt 文件 中 的 内 容 进行 修改 。 并 再 次 执行 ASPNET 页 面 ， 会 发 现 
在 10 分 钟 之 内 显示 的 内 容 都 与 图 9-5 所 示 相 同 。 这 也 说 明了 输出 缓存 起 到 了 存储 数据 的 作用 。 
当 超过 10 分 钟 之 后 再 次 刷新 页 面 ， 此 时 将 显示 最 新 的 文件 内 容 并 再 次 缓存 10 分 钟 。 

这 种 机 制 可 以 有 效 地 减少 频繁 对 文件 执行 读 取 操 作 造 成 的 网 络 堵塞 ， 从 而 提高 响应 速度 。 


< 和 


9.3 ”管理 缓存 的 数据 


在 使 用 CacheDuration 选项 启用 输出 缓存 时 , ASPNET 将 会 为 每 个 Web 服务 方法 单独 开辟 
缓存 空间 ， 也 就 是 说 缓存 仅 针 对 该 方法 有 效 。 

如 果 希 望 在 应 用 程序 的 生命 周期 内 共享 缓存 中 的 响应 ， 则 必须 使 用 应 用 程序 缓存 。 例 如 ， 
可 以 将 应 用 程序 内 那些 频繁 访问 的 数据 ， 以 及 那些 需要 大 量 时 间 来 创建 的 数据 存储 在 内 存 中 ， 
从 而 提高 性 能 。 


< 视频 教学 : 光盘 /videos/09/ 管 理 缓存 的 数据 .avi 长 度 : 16 分 钟 


9.3.1 基础 知识 一 一 使 用 应 用 程序 缓存 


输出 缓存 只 存储 Web 服务 方法 的 结果 ， 而 使 用 应 用 程序 缓存 可 以 存储 任何 类 型 的 信息 。 

应 用 程序 缓存 实际 上 是 由 属于 System.Web.Caching 命名 空间 的 Cache 类 实现 的 。 通 过 对 
Cache 类 的 应 用 ， 可 轻松 实现 添加 、 检 索 和 移 除 应 用 程序 数据 缓存 ， 以 及 移 除 缓存 项 时 通知 应 
用 程序 等 功能 。 

Cache 类 是 一 个 简单 字典 集合 ， 在 Web 服务 中 可 以 通过 “this.Context.Cache” 来 访问 这 个 
类 的 对 象 实例 ， 并 且 可 以 像 使 用 Application 和 Session 对 象 一 样 来 访问 Cache 对 象 。 


》 不 要 把 Context.Cache 对 象 与 Context.Response.Cache 对 象 相 混淆 。 前 者 是 
注意 | System.Web.Caching.Cache 类 的 一 个 实例 ， 后 者 则 引用 了 System.Web.HttpCache 
Policy 类 。 而且 HttpCachePolicy 用 于 为 Web 页 面 配置 输出 缓存 ， 对 于 Web 服务 

来 说 毫 无 用 处 。 


Cache 对 象 与 Application 对 象 相 比 ， 其 工作 方式 主要 有 以 下 两 个 区 别 。 
@ Cache 由 ASPNET 控制 ， 当 应 用 程序 关闭 或 者 内 存 不 足 时 会 将 其 删除 。 这 意味 着 在 
尝试 使 用 已 经 缓存 的 对 象 之 前 ， 必 须 验 证 它 是 否 存在 。 和 否则， 可 能 会 导致 空 引用 的 
) 异常 。 
@ ”Cache 对 象 是 线程 安全 的 。 也 就 是 说 开发 人 员 不 必 在 添加 或 者 删除 缓存 项 时 使 用 LockO 
和 Unlock0 这 样 的 方法 (Application 对 象 需要 管理 用 户 的 并 发 问题 )。 当 然 ， 如 果 在 组 
存 中 存储 的 对 象 不 是 线程 安全 的 , 并 且 有 不 止 一 个 客户 试图 同时 更 改 或 者 使 用 这 个 对 
象 ， 那么 仍然 可 能 遇 到 并 发 问题 。 这 种 情况 的 解决 办 法 是 ， 可 以 在 缓存 中 创建 缓存 项 
的 一 个 临时 副本 ， 然 后 在 Web 方法 中 使 用 这 个 副本 。 
使 用 应 用 程序 缓存 的 缺点 是 需要 编写 实现 缓存 的 代码 ， 不 过 这 些 代码 可 以 容易 地 与 Web 
服务 方法 分 开 。 
@° 应 用 程序 缓存 的 生命 周期 依赖 于 应 用 程序 的 生命 周期 。 如 果 重 新 启动 应 用 程序 ， 
由 到 | ”将 会 重新 创建 Cache 对 象 。 
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1. 向 缓存 中 添加 项 


在 开始 使 用 应 用 程序 缓存 之 前 ， 首 先 需 要 添加 要 存储 的 信息 。 具 体 方法 就 像 使 用 
Application 和 Session 对 象 一 样 ， 只 需 为 Cache 对 象 指定 一 个 键 名 就 可 以 向 应 用 程序 缓存 添加 
一 个 新 项 。 

例如 ， 下 面 的 代码 演示 了 使 用 这 种 方式 存储 不 同类 型 的 数据 。 

// 在 应 用 程序 缓存 中 存储 字符 串 型 数据 

this.Context.Cache["LastLoginTime"] = DateTime.Now.ToSstring(); 

// 在 应 用 程序 缓存 中 存储 布尔 值 型 数据 

this.Context.Cache["IsVIP"] = false; 

// 在 应 用 程序 缓存 中 存储 整 型 数据 

this.Context.Cache ["MaxPage"] = 100; 

// 在 应 用 程序 缓存 中 存储 自 定义 对 象 

User UserInfo=new User(); 

this.Context .cache["User"] = UserInfo; 


使 用 这 种 方法 可 以 很 简单 地 向 应 用 程序 缓存 中 添加 需要 存储 的 数据 , 但 是 它 的 缺点 是 无 法 
控制 数据 的 过 期 时 间 。 

因此 , 更 好 的 方法 是 调用 Cache 类 提供 的 Insert0 方 法 向 Cache 对 象 中 插入 一 项 作为 应 用 程 
序 缓存 。 在 插入 时 也 可 以 指定 数据 的 键 名 和 值 ， 例 如 下 面 演示 了 这 种 方式 的 代码 : 

// 使 用 Insert () 方 法 存储 整 型 数据 

this.Context.Cache.Insert ("OnLineUsers",100); 

// 使 用 Insert () 方 法 存储 字符 串 型 数据 

this.Context.Cache.Insert ("SiteURL", "http://www.itzcn.com"); 


// 使 用 Insert () 方 法 存储 自 定义 对 象 


this.Context.Cache.Insert ("User",UserInfo); 


除 此 之 外 ，Insert0 方 法 还 提供 了 很 多 用 于 控制 缓存 的 重 载 形 式 ， 它 们 的 语法 如 下 : 

public void Insert(string key, object value); 

使 用 key 指定 的 键 名 将 value 值 添加 到 缓存 ， 并 使 用 默认 的 优先 级 和 过 期 时 间 。 这 种 形式 
与 使 用 “Cache[" 键 "]= 值 ”的 语法 相同 。 

public void Insert (string key, object value, CacheDependency dependencies); 


使 用 key 指 定 的 键 名 将 value 值 添加 到 缓存 , 并 使 用 默认 的 优先 级 和 过 期 时 间 。Dependencies 
参数 用 于 指定 一 个 文件 或 者 已 缓存 项 的 CacheDependency 对 象 , 当 它 发 生 改变 时 使 缓存 项 失效 。 


public void Insert (string key, object value, CacheDependency dependencies, 


DateTime absoluteExpiration, TimeSpan slidingExpiration); 
使 用 key 指定 的 键 名 将 value 值 添加 到 缓存 ， 并 使 用 默认 的 优先 级 ， 还 可 以 指定 一 个 过 期 
时 间 。 这 是 Insert0 方 法 最 常用 的 重 载 形式 。 


public void Insert(string key, object value, CacheDependency dependencies, 
DateTime absoluteExpiration, TimeSpan slidingExpiration, CacheItemPriority 
priority, CacheItemRemovedCallback onRemoveCallback); 


< 人 mm 


这 是 Insert( 方 法 最 完整 的 重 载 形式 ， 可 以 配置 缓存 的 每 个 方面 , 包括 过 期 时 间 、 依 赖 性 和 
优先 级 等 。 此 外 ， 还 可 以 通过 一 个 委托 来 指定 删除 缓存 时 要 调用 的 回调 函数 。 

2. 设置 项 的 过 期 选项 

在 使 用 应 用 程序 缓存 时 ， 可 以 通过 两 种 方式 来 指定 缓存 项 的 过 期 时 间 。 第 一 种 是 固定 过 
期 时 间 的 方式 ， 即 它 在 超过 指定 的 一 段 时 间 之 后 过 期 ， 就 像 输 出 缓存 的 CacheDuration 一 样 。 
这 种 方式 对 于 数据 在 固定 时 间 内 有 效 时 是 最 合适 的 。 例 如 ， 使 用 这 种 方式 保留 上 次 查询 结果 
60 秒 。 

下 面 的 代码 演示 了 使 用 这 种 方式 将 一 个 项 缓存 10 分 钟 : 


this.Context.Cache.Insert ("Size", "1000", null, DateTime.Now.AddMinutes (10), 
TimeSpan.Zero); 


第 二 种 方式 是 指定 一 个 动态 过 期 时 间 ， 此 时 ASP.NET 将 等 待 一 段 非 活动 时 间 后 再 处 理 被 
忽视 的 缓存 项 。 例 如 ， 指 定 动态 过 期 时 间 为 1 小 时 ， 那 么 只 有 在 1 小 时 内 没有 使 用 的 项 才 会 被 
删除 。 若 某 项 可 能 在 短 短 的 20 分 钟 后 失效 ， 但 如 果 对 其 有 持续 的 需要 ， 那 么 该 项 将 会 被 无 限 
期 地 保留 。 这 种 方式 对 于 那些 信息 总 是 有 效 ， 但 是 需求 可 能 不 高 的 项 非常 有 用 。 例 如 ， 对 于 搜 
索 服务 可 能 会 检索 的 历史 数据 ， 像 调查 报告 ， 它 们 不 会 因为 不 再 有 效 而 过 期 。 

如 果 要 使 用 这 种 方式 ， 需 要 将 Insert0 方 法 的 absolutExpiration 参数 设置 为 “DateTime. 
MaxValue”。 下 面 的 代码 演示 了 使 用 这 种 方式 创建 一 个 缓存 项 , 直到 该 项 10 分 钟 内 没有 被 使 用 。 

this.Context.Cache.Insert ("Size", "1000", null, DateTime.MaxValue, 

TimeSpan.FromMinutes (10)); 


由 


@ $ 在 创建 一 个 缓存 项 时 不 能 同时 使 用 上 面 的 两 种 方式 ,否则 会 报 出 ArgumentException 
注意 异常 。 
3. 缓存 优先 级 
当 我 们 使 用 Insert0 方 法 创建 缓存 项 时 , 根据 使 用 重 载 形式 的 不 同 , 缓存 项 的 优先 级 可 能 
赋予 了 默认 值 。 当 然 ， 也 可 以 通过 Insert0 方 法 的 priority 参数 来 更 改 为 指定 优先 级 。 
priority 参数 是 CacheItemPriority 类 型 的 一 个 枚 举 值 ， 如 表 9-1 所 示 给 出 了 可 选 的 值 及 其 
说 明 。 
表 9-1 CacheltemPriority 枚 举 值 


值 说 明 

Low 在 服务 器 释放 系统 内 存 时 ， 具 有 该 优先 级 级 别 的 缓存 项 最 有 可 能 被 从 缓存 删除 

dl 在 服务 器 释放 系统 内 存 时 ， 具 有 该 优先 级 级 别 的 缓存 项 比分 配 了 Normal 优先 级 的 项 更 
有 可 能 被 从 缓存 删除 

ee 在 服务 器 释放 系统 内 存 时 , 具有 该 优先 级 级 别 的 缓存 项 很 有 可 能 被 从 缓存 删除 ,其 被 删 
除 的 可 能 性 仅 次 于 具有 Low 或 BelowNormal 优先 级 的 那些 项 。 这 是 默认 选项 

Default 缓存 项 优先 级 的 默认 值 为 System.Web.Caching.CacheItemPriority.Normal 

ve 在 服务 器 释放 系统 内 存 时 ， 具 有 该 优先 级 级 别 的 缓存 项 被 删除 的 可 能 性 比分 配 了 
Normal 优先 级 的 项 要 小 
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续 表 
值 说 明 


High | 在 服务 器 释放 系统 内 存 时 ， 具 有 该 优先 级 级 别 的 缓存 项 最 不 可 能 被 从 缓存 删除 


在 服务 器 释放 系统 内 存 时 , 具有 该 优先 级 级 别 的 缓存 项 将 不 会 被 自动 从 缓存 删除 。 但 是 ， 
具有 该 优先 级 级 别 的 项 会 根据 项 的 固定 到 期 时 间 与 其 他 项 一 起 被 移 除 


NotRemovable 


@' 优先 级 对 于 缓存 清理 来 说 非常 重要 。 当 ASP.NET 检测 到 服务 器 内 存 不 足 时 ， 它 将 
提示 | ”有 选择 地 删除 不 经 常 使 用 并 且 优先 级 最 低 的 项 。 


4. Cache 类 其 他 成 员 


在 本 节 前 面 , 我 们 学 习 了 Cache 类 中 Insert( 方 法 的 使 用 ,该 方法 可 以 向 应 用 程序 中 添加 组 
存 ， 并 指定 过 期 时 间 和 缓存 优先 级 等 。 

此 外 ， 在 Cache 类 中 还 提供 了 很 多 成 员 来 辅助 对 缓存 的 控制 。 如 表 9-2 所 示 列 出 了 这 些 成 
员 名 称 及 其 说 明 。 


表 9-2 Cache 类 其 他 成 员 


成 员 名 称 说 明 
Add0 方 法 该 方法 用 于 添加 一 个 缓存 项 ， 语 法 与 Insert0 方 法 的 第 4 种 重 载 形式 相 同 
Count 属性 该 属性 返回 当前 应 用 程序 中 缓存 项 的 数量 
Get0 方 法 该 方法 可 以 根据 key 来 检索 指定 的 缓存 项 并 返回 ， 如 果 未 找到 则 返回 null 
Remove0 方 法 该 方法 可 以 根据 key 来 从 应 用 程序 中 删除 一 个 缓存 项 


例如 ， 下 面 的 代码 使 用 Remove0 方 法 实现 了 清理 整个 应 用 程序 缓存 。 


public void ClearCache() 
{ 
// 使 用 DictionaryEntry 遍历 当前 的 应 用 程序 缓存 
foreach (DictionaryEntry objItem in this.Context.Cache) 


{ 


// 获 取 当 前 缓存 项 的 key 
string CacheKey = objItem.Key.Tostring(); 
// 删 除 该 缓存 项 


this.Context.Cache.Remove (CacheKey) 7 


9.3.2 ”实例 描述 


作为 一 名 站 长 ， 网 站 上 线 之 后 ， 第 一 个 需要 考虑 的 就 是 如 何 将 网 站 流量 变现 ， 即 通过 网 站 
实现 收入 。 这 个 实现 方式 有 多 种 ， 广 告 便 是 其 中 之 一 。 

在 显示 广告 之 前 ， 我 们 首先 需要 对 广告 的 位 置 有 一 个 规划 。 例 如 显示 哪 种 类 型 的 广告 ， 使 
用 什么 样 的 样式 ， 都 在 哪些 位 置 显 示 ， 以 及 显示 的 开始 和 终止 时 间 等 。 另 外 ， 为 了 使 广告 不 影 
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响 网 站 的 加 载 速度 通常 都 会 保存 到 缓存 中 ， 并 在 需要 的 时 候 进行 清理 。 


下 面 的 实例 介绍 了 如 何在 Web 服务 中 通过 应 用 程序 缓存 来 管理 广告 位 。 


9.3.3 ”实例 应 用 


送 


【 例 9-2】 管理 缓存 的 数据 
(1) 创建 一 个 名 为 “AdWebService.asmx” 的 Web 服务 ， 并 引用 以 下 的 命名 空间 。 


using System.Web.Caching; 
using System.Collections; 


(2) 在 Web 服务 所 在 的 项 目下 创建 一 个 Advertisement.cs 文件 。 它 保存 的 是 一 个 广告 实体 
具体 成 员 及 其 构造 函数 如 下 : 


public class Advertisement 
{ 
public Advertisement () 
{ 
} 
public Advertisement (int id, string title, string type, string style, 
DateTime starttime, DateTime endtime, string target) 
{ 
this.ID = id; 
Enis- TLICLIe = Dtier 
this.Type = type; 
this.Style = style; 
this.StartTime = starttime; 
this.EndTime = endtime; 
this.Target = target; 
} 


public int ID; // 广 告 编号 
public string Title { get; set; } // 广 告 标题 
public string Type { get; set; } // 广 告 类 型 
public string Style { get; set; } // 广 告 样式 
public DateTime StartTime { get; set; } // 广 告 开始 时 间 
public DateTime EndTime { get; set; } // 广 告 结束 时 间 
public string Target { get; set; } // 广 告 投放 目标 


} 
如 上 述 代码 所 示 ，Advertisement 类 包括 了 7 个 属性 以 及 两 个 构造 函数 ， 其 中 无 参 构造 函数 


用 于 实例 化 空 类 ， 有 参 构造 函数 在 实例 化 时 可 以 指定 数据 。 


(3) 返回 到 Web 服务 中 ， 编 写 一 个 InitAdList0 方 法 对 广告 位 进行 初始 化 ， 包 括 指定 一 些 


广告 位 和 当前 用 户 ， 再 将 它们 添加 到 缓存 中 。 具 体 实 现代 码 如 下 所 示 : 


Ed > 


List<Advertisement> list; 7/ 定 义 一 个 广告 列表 
public void InitAdList() 
{ 

// 初 始 化 广告 位 
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list = new List<Advertisement> 
{ 
new advertisement (1, "视频 推广 的 首页 广告 ", "页 首 通栏 广告 ", "图 片 "，, new 
DateTime (2011,1,1) ,new DateTime (2011,12,31)," 整 站 ")， 
new Advertisement (2, "新 书 推荐 广告 ", "页 首 对 联 广 告 ", "图 片 ", new 
DateTime (2011,5,1) ,new DateTime (2011,5,7), "学 院 模块 ")， 
new Rdvertisement (3, "赞助 商 文字 广告 ", "页 尾 版 权 下 方 广 告 ", "文字 ", new 
DateTime (2011,1,1) ,new DateTime (2011,12,31), "首页 ") 
]7 
// 将 当前 用 户 保存 到 应 用 程序 缓存 中 
this.Context.Cache.Insert ("user", "Administraotr", null, 
DateTime.Now.AddMinutes(30), TimeSpan.Zero); 


// 将 当前 的 广告 列表 保存 到 应 用 程序 缓存 中 


this.Context.Cache.Insert ("ad", list, null, DateTime.Now.AddHours (1), 
TimeSpan.Zero); 


} 
(4) 创建 一 个 InsertAd0 方 法 允许 用 户 向 列表 中 添加 一 个 新 的 广告 。 实 现代 码 如 下 所 示 : 


[WebMethod] 
public List<Advertisement> InsertAd (Advertisement ad) 


{ 


list = GetAllAd(); // 获 取 当 前 广告 列表 
list.Add (ad); // 添 加 新 的 广告 到 列表 
return list; // 返 回 当前 广告 列表 


} 
(5) InsertAd() 方 法 中 先 调 用 GetAllAd() 方 法 获取 当前 保存 在 缓存 中 的 广告 列表 .GetAllAd0 
的 具体 实现 如 下 : 


[WebMethod] 

public List<Advertisement> GetAl]lAd() 

: if (this.Context.Cache["ad"] == null) // 判 断 缓存 中 是 否 有 广告 列表 
InitadList () 7 // 没 有 就 执行 初始 化 
i 


{ 
list = (List<Advertisement>)this.Context.Cache["ad"]; // 有 就 直接 返回 


P 


return list; 


¥ 
(6) 接 下 来 创建 一 个 从 缓存 中 删除 指定 键 的 RemoveAd0, 它 调用 了 Cache 对 象 的 Remove() 
方法 。 代 码 如 下 所 示 : 


[WebMethod] 
public void RemoveAd(string key) 


this.Context.Cache.Remove (key); 


} 


< 人 mm 


(7) 再 创建 一 个 ClearCache() 方 法 来 删除 当前 缓存 的 所 有 内 容 。 代 码 如 下 所 示 : 


[WebMethod] 

public void ClearCache () 
// 使 用 DictionaryEntry 来 遍历 当前 的 应 用 程序 缓存 
foreach (DictionaryEntry objItem in this.Context.Cache) 
{ 


// 获 取 当 前 缓存 项 的 key 
string CacheKey = objItem.Key.ToString(); 
// 删 除 该 缓存 项 


this.Context.Cache.Remove (CacheKey); 


|: 
(8) 最 后 创建 一 个 GetUserName0) 方 法 判断 缓存 中 是 否 存 在 用 户 ， 并 返回 一 个 字符 串 。 实 
现代 码 如 下 所 示 : 


[WebMethod] 
public string GetUserName() 


i 


if (this.Context.Cache["user"] == null) // 判 断 缓存 中 是 否 存在 用 户 
{ 
return "未 登录 用 户 "; // 没 有 则 返回 这 个 字符 串 
} 
else 


{ 
return this .Context.Cache["user"] .ToString() 7 // 有 则 返回 缓存 的 用 户 名 
} 
} 


(9) 到 此 为 止 ， 针 对 Web 服务 的 编码 工作 就 完成 了 。 下 面 创建 一 个 ASPX 页 面 对 上 面 的 
Web 服务 进行 调用 。 

(10) 添加 对 AdWebService.asmx 的 Web 引用 ， 引 用 名 称 为 “adService”。 

(11) 在 ASPX 页 面 中 添加 显示 当前 用 户 和 广告 列表 的 布局 。 如 图 9-6 所 示 为 本 实例 中 使 用 
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9-6 设计 布局 


(12) 转 到 后 台 代码 文件 ， 对 Page_ Load( 方 法 进行 修改 。 在 这 里 首先 实例 化 一 个 Web 服务 
类 ， 然 后 获取 广告 和 用 户 信息 并 显示 到 页 面 上 。 这 部 分 代码 如 下 所 示 : 


mS) > 
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adService.AdWebService ads; 

adService.Advertisement[] list; 

protected void Page Load(object sender, EventArgs e) 

{ 
ads = new adService.AdWebservice(); // 实 例 化 Web 服务 类 
if (!IsPostBack) 
{ 


list = ads.GetAl1Ad(); // 获 取 广 告 列表 
} 
Repeater1.DataSource = list; // 指 定数 据 源 
Repeaterl .DataBind(); // 绑 定 显示 
ltUser.Text = ads.GetUserName (); // 显 示 当 前 用 户 


} 
(13) 在 广告 列表 的 下 方 制作 一 个 广告 位 添加 的 表单 ， 最 终 效果 如 图 9-7 所 示 。 
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图 9-7 制作 添加 广告 位 布局 


(14) 进入 【添加 】 按 钮 的 单 击 事件 ， 编 写 代码 调用 Web 服务 的 InsertAd0 方 法 实现 添加 效 
果 。 具 体 实现 代码 如 下 所 示 : 


protected void Button]l Click(object sender, EventArgs e) 

1 
adService.Advertisement newAD = new adService.Advertisement (); 

// 创 建 一 个 广告 类 实例 

newAD.ID = 5; 
newAD.Title = txtTitle.Text.Trim(); 
newAD.Type = ddlType.SelectedValue; 
newRAD.Style = ddlstyle.SelectedValue; 
newAD.StartTime = System.Convert.ToDateTime (txtStartTime .Text.Trim()) 7 
newAD.EndTime = System.Convert.ToDateTime (txtEndTime.Text.Trim()); 
newAD.Target = ddlTarget.SelectedValue; 


ads.InsertAd (newAD); // 调 用 Insertad () 方 法 
list = ads.GetAllAd(); // 获 取 最 新 的 列表 
Repeaterl.DataSource = list; 
Repeaterl.DataBind(); // 重 新 绑 定 

// 添 加 成 功 


Page.ClientScript.RegisterStartupScript (this.GetType()， 7 
"<script>alert (' 添 加 广告 成 功 ! ')</script>"); 


< 很 一 
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如 上 述 代码 所 示 ， 这 里 使 用 了 InsertAd0 和 GetAllAd0 两 个 Web 服务 方法 ， 并 在 最 后 弹出 
一 个 提示 对 话 框 。 
(15) 在 本 页 面 再 添加 一 个 用 于 更 新 缓存 的 布局 ， 主 要 包含 了 两 个 按钮 ， 如 图 9-8 所 示 。 
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图 9-8 制作 更 新 缓存 布局 


(16) 更 新 广告 缓存 调用 的 是 RemoveAd() 方 法 ， 并 指定 键 名 来 删除 广告 缓存 。 实 现代 码 如 
下 所 示 : 
protected void btnUpdateAdCache Click(object sender, EventArgs e) 
{ 
ads.RemoveAd ("ad"); 
Page.ClientScript.RegisterStartupScript (this.GetType(), "", 
"<script>alert (' 更 新 广告 缓存 成 功 ! ')</script>"); 
} 


(17) 清理 所 有 缓存 则 会 删除 当前 所 有 的 缓存 项 ， 它 调用 的 是 ClearCache() 方 法 。 实 现代 码 
如 下 所 示 : 


protected void btnClearAllCache Click(object sender, EventArgs e) 
{ 
ads.ClearCache (); 
Page.ClientScript.RegisterStartupScript (this.GetType(), "", 
"<script>alert (' 清 理 缓存 成 功 ! ')</script>"); 
} 
(18) 经 过 上 面 创建 Web 服务 ， 添 加 Web 服务 方法 ， 创 建 ASPX 页 面 ， 制 作 布局 以 及 编码 
工作 ， 至 此 实例 就 算 完成 了 。 


9.3.4 ”运行 结果 


在 Visual Studio 中 编译 上 面 创建 的 Web 服务 项 目 和 ASP.NET 项 目 。 然 后 从 ASP.NET 
项 目 中 运行 页 面 ， 此 时 由 于 添加 了 对 Web 服务 的 引用 ，Visual Studio 会 同时 启动 Web 服务 


图 9-9 所 示 为 页 面 打开 后 的 默认 效果 ， 可 以 看 到 显示 了 当前 用 户 和 一 个 广告 列表 。 
在 页 面 下 方 的 添加 广告 位 区 域 中 输入 广告 位 信息 ， 再 单 击 【添加 】 按 钮 ， 会 看 到 提示 对 话 
框 ， 如 图 9-10 所 示 。 
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单 击 【 确 定 】 按 钮 返回 页 面 ， 在 广告 列表 中 会 看 到 新 增 的 广告 位 信息 ， 如 图 9-11 所 示 。 
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图 9-11 添加 后 的 广告 列表 


现在 测试 更 新 缓存 的 效果 。 单 击 【 更 新 广告 缓存 】 按 钮 会 看 到 提示 对 话 框 ， 同 时 页 面 上 的 
广告 列表 消失 了 ， 如 图 9-12 所 示 。 


IE 


图 9-12 更 新 广告 缓存 效果 
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单 击 【清理 所 有 缓存 】 按 钮 ， 此 时 在 缓存 中 的 用 户 名 也 被 删除 。 因 此 ， 在 页 面 上 会 看 到 提 
示 对 话 框 ， 以 及 背后 的 “当前 用 户 : 末 登 录用 户 ”文字 ， 如 图 9-13 所 示 。 
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9-13 ”清理 所 有 缓存 效果 


9.3.5 ”实例 分 析 


pe 


在 本 实例 中 ， 主 要 是 通过 泛 型 来 管理 广告 列表 ， 并 通过 它 保存 到 缓存 供 客户 端 调用 。 但 是 
这 里 要 注意 ，Web 服务 中 的 List<Advertisement> 类 型 ， 在 客户 端 时 变 成 了 Advertisement[]。 

另外 ,在 为 Repeater 控 件 指定 数据 源 并 绑 定之 后 ,在 页 面 上 应 该 使 用 “<9%# Eval(" 属 性 ")%>” 
的 方式 显示 数据 。 


9.4 解决 各 个 缓存 间 的 依赖 性 


根据 前 面 的 知识 可 以 看 到 ， 我 们 创建 的 应 用 程序 缓存 项 主要 可 以 通过 3 种 方式 来 删除 。 

@ 缓存 项 在 超过 指定 的 过 期 选项 后 自动 失效 。 

@ ”使 用 Cache.Remove0 方 法 手动 删除 缓存 项 。 

@ 由 ASPNET 来 删除 缓存 项 以 释放 服务 器 内 存 。 

除 此 之 外 ， 还 可 以 通过 缓存 的 依赖 性 来 指定 它 的 过 期 时 间 。 即 ， 在 创建 缓存 项 时 为 其 指定 
一 个 所 依赖 的 对 象 ， 例 如 一 个 配置 文件 。 这 样 ， 当 这 个 对 象 发 生变 化 时 ， 依 赖 它 的 所 有 缓存 项 
都 将 被 自动 删除 。 
人 视频 教学 : 光盘 /videos/09/ 解 决 缓存 间 的 依赖 性 .avi 加 长 度 : 10 分 钟 

要 为 一 个 应 用 程序 缓存 项 指定 依赖 性 需要 使 用 CacheDependency 类 ， 该 类 位 于 


System.Web.Caching 命名 空间 。 
CacheDependency 类 管理 缓存 项 依赖 性 的 方式 如 下 。 


ms >> 
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(1) 创建 一 个 CacheDependency 对 象 ，ASP.NET 将 开始 监视 指定 的 文件 和 缓存 项 。 

(2) 使 用 Insert0 方 法 创建 一 个 应 用 程序 缓存 项 ， 并 指定 为 上 面 创建 的 CacheDependency 
对 象 。 

(3) 如 果 CacheDependency 对 象 引 用 的 文件 更 改 了 ， 那 么 ASP.NET 将 删除 依赖 于 它 的 组 
存 项 。 

CacheDependency 类 提供 了 8 个 不 同 的 构造 函数 ， 如 下 所 示 : 


public CacheDependency (string filename) 7 


初始 化 一 个 CacheDependency 类 的 新 实例 监视 文件 或 目录 的 更 改 情况 。 当 该 资源 更 改 时 ， 
缓存 的 对 象 将 过 期 ， 并 从 缓存 中 移 除 。 


public CacheDependency (string[] filenames); 


初始 化 一 个 CacheDependency 类 的 新 实例 ， 它 监视 一 组 (文件 或 者 目录 ) 路 径 的 更 改 情况 。 
当 这 些 资源 中 的 任何 一 个 更 改 时 ， 缓 存 的 对 象 即 过 期 ， 并 从 缓存 中 移 除 。 


public CacheDependency (string filename, DateTime start); 


初始 化 一 个 CacheDependency 类 的 新 实例 ， 并 从 指定 的 时 间 开 始 监视 文件 或 目录 的 更 改 
情况 。 


public CacheDependency (string[] filenames, DateTime start); 


初始 化 一 个 CacheDependency 类 的 新 实例 ， 并 从 指定 的 时 间 开 始 监视 一 组 (文件 或 者 目录 ) 
路 径 的 更 改 情况 。 


public CacheDependency (string[] filenames, string[] cachekeys); 


初始 化 一 个 CacheDependency 类 的 新 实例 ， 它 监视 一 组 (文件 或 者 目录 ) 路 径 或 者 缓存 键 的 
更 改 情况 ， 还 可 以 同时 监视 两 者 。 


public CacheDependency (string[] filenames, string[] cachekeys, CacheDependency 
dependency); 


初始 化 一 个 CacheDependency 类 的 新 实例 ， 它 监视 一 组 (文件 或 者 目录 ) 路 径 或 者 缓存 键 的 
更 改 情况 ， 还 可 以 同时 监视 两 者 。 此 外 ， 还 可 以 指定 一 个 它 本 身 所 依赖 的 CacheDependency 类 
实例 。 

public CacheDependency (string[] filenames, string[] cachekeys, DateTime 

start); 

初始 化 一 个 CacheDependency 类 的 新 实例 ， 并 从 指定 的 时 间 开 始 监视 一 组 (文件 或 者 目录 ) 
路 径 或 者 缓存 键 的 更 改 情况 ， 还 可 以 同时 监视 两 者 。 

public CacheDependency (string[] filenames, string[] cachekeys, CacheDependency 

dependency, DateTime start); 

初始 化 一 个 CacheDependency 类 的 新 实例 ， 它 监视 一 组 (文件 或 者 目录 ) 路 径 或 者 缓存 键 的 
更 改 情况 ， 还 可 以 同时 监视 两 者 。 此 外 ， 还 可 以 指定 一 个 它 本 身 所 依赖 的 CacheDependency 类 
实例 以 及 开始 监视 的 时 间 。 
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使 用 CacheDependency 类 创建 依赖 性 也 非常 容易 ,只 需 根 据 要 求 选 择 合适 的 构造 函数 创建 
新 实例 即 可 。 但 是 要 注意 ， 指 定 文件 时 需要 使 用 绝对 路 径 。 如 果 我 们 要 使 用 与 Web 服务 相同 
的 目录 ， 则 可 以 使 用 Server.MapPath0 方 法 来 确定 绝对 路 径 。 

例如 ， 下 面 的 代码 添加 一 个 键 名 为 “DSN” 的 缓存 项 ， 并 指定 依赖 于 文件 config.xml。 这 
里 的 config.xml 与 Web 服务 在 相同 目录 ， 而 且 当 它 发 生变 化 时 ，DSN 将 会 从 Cache 中 删除 。 


this.Context.Cache.Insert ("DSN", Connectionstring, 
new CacheDependency (Server.MapPath ("config.xml")) 
1 


另外 ， 还 可 以 将 现 有 的 缓存 项 作为 依赖 ， 从 而 创建 一 个 新 的 缓存 项 。 例如， 下 面 的 示例 代 
码 缓存 了 3 个 DataTable 对 象 ， 这 些 对 象 分 别 表示 产品 清单 、 产 品类 别 和 产品 价格 。 其 中 ， 产 
品 清单 的 DataTable 依赖 于 产品 类 别 DataTable 和 产品 价格 DataTable。 如 果 删 除 这 两 个 项 目 中 
的 任何 一 个 ， 产 品 清单 也 将 被 删除 。 


[WebMethod] 

public void InvalidationTest () 

{ 
// 创 建 3 个 DataTable 
DataTable dtPrices = new DataTable ("Prices"); 
DataTable dtCategories = new DataTable ("Categories"); 
DataTable dtList = new DataTable ("Products"); 
// 先 向 应 用 程序 中 添加 两 个 缓存 项 
this.Context.Cache.Insert ("Prices", dtPrices); 
this.Context.Cache.Insert ("Categories", dtCategories); 
// 创 建 一 个 字符 串 数组 并 指定 为 上 述 两 个 项 的 键 名 
string[] keys={"Prices","Categories"}; 
// 创 建 一 个 依赖 项 
CacheDependency dependency=new CacheDependency (null, keys); 
// 再 添加 一 个 缓存 项 ， 并 指定 它 依赖 于 上 面 创建 的 dependency 


this.Context.Cache.Insert ("ProductList", dtList, dependency); 
} 


下 面 通过 一 个 简单 的 示例 来 学 习 如 何 使 用 CacheDependency 类 设置 缓存 的 依赖 项 。 具体 步 
又 如 下 。 

(1) 创建 一 个 名 为 “DependencyService.asmx” 的 Web 服务 文件 。 

(2) 添加 对 如 下 两 个 命名 空间 的 引用 。 


using System.Web.Caching; 
using System.I0; 


(3) 添加 一 个 名 为 “SetFileDependency0 ”的 Web 服务 方法 。 在 该 方法 中 使 用 Cache 对 象 
创建 一 个 应 用 程序 缓存 项 ， 并 指定 它 依赖 于 同 目录 下 的 products.xml 文件 。 代 码 如 下 所 示 : 

[WebMethod] 

public void SetFileDependency() 


{ 


Product p = new Product (); 
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CacheDependency dependency = new 
CacheDependency (Server.MapPath ("products.xml")); 
this.Context.Cache.Insert ("proList", p, dependency); 
} 
如 上 述 代码 所 示 ， 这 里 缓存 的 键 名 为 “proList”， 它 的 值 是 一 个 自 定义 Product 对 象 的 实 
例 。 如 下 所 示 为 Product 对 象 的 定义 : 


public class Product 


public string Name; 
public decimal Price; 


} 
(4) 下 面 编 写 CheckDependentItem() 方 法 的 代码 , 检索 Cache 对 象 并 判断 proList 缓存 项 是 


否 有 效 ， 并 返回 结果 。 代 码 如 下 所 示 : 


[WebMethod] 
public string CheckDependentItem() 


{ 


if (this.Context.Cache["proList"] == null) 


{ 
return "proList 缓存 项 已 经 被 删除 。"; 


上 


else 


return "proList 缓存 项 还 有 效 。"; 


} 
(5) 再 添加 一 个 ChangeFile() 方 法 通过 程序 的 方式 对 products.xml 文件 执行 修改 操作 。 代 


码 如 下 所 示 : 
[WebMethod] 
public void ChangeFile() 


{ 
StreamWriter sw = File.CreateText (Server.MapPath ("products.xml")); 


sw.Flush(); 
sw.Close(); 
1 
(6) 至 此 ， 对 Web 服务 的 编写 就 完成 了 。 下 面 创建 一 个 ASPX 页 面 测试 Web 服务 的 缓存 
是 否 有 效 。 在 页 面 加 载 的 Page_Load0 中 编写 如 下 代码 : 
protected void Page_Load (object sender, EventArgs e) 
{ 


DependencyService.DependencyService ds = new 


DependencyService.DependencyService(); 


Response.Write ("创建 一 个 键 名 为 proList 的 应 用 程序 缓存 项 。<br/>"); 


ds.SetFileDependency(); 
Response.Write ("调用 CheckDependentItem() 方法 验证 是 否 存 在 该 项 。<br/>"); 


< 寺 一 


SW 


string message=ds.CheckDependentItem(); 

Response.Write ("结果 : "+message); 

Response.Write ("<hr/><br/> 调 用 changeFile() 方 法 对 products .xml 文件 进行 修改 。 
CE > 

ds.ChangeFile(); 

Response.Write ("再 次 调用 CheckDependentItem() 方 法 验证 是 否 存 在 该 项 。<br/>"); 

message=ds.CheckDependentItem(); 

Response.Write ("结果 : " + message); 


} 
(7) 在 上 述 代码 中 ，DependencyService 是 对 Web 服务 的 引用 名 称 。 页 面 运行 后 的 输出 结 
果 如 图 9-14 所 示 。 


二 用 ClaaeeFle0 方 法 对 人 
号 并 调用 EE: 
后 昌 ，proLid 扩 存 项 已经 法 测 


图 9-14 ”测试 缓存 依赖 性 


从 图 9-14 所 示 的 输出 可 以 看 到 ， 在 创建 了 一 个 CacheDependency 对 象 之 后 ，ASP.NET 就 
开始 监视 依赖 项 。 一 旦 依赖 发 生 了 变化 ， 那 么 ASP.NET 将 移动 依赖 它 的 缓存 项 。 


9.5 ”为 删除 缓存 项 指定 回调 函数 


在 使 用 Insert0 方 法 添加 缓存 项 时 , 如 果 为 其 指定 了 一 个 回调 函数 。 那么 当 从 缓存 中 删除 该 
项 时 ，ASP.NET 会 先 调用 指定 的 回调 函数 ， 再 执行 删除 操作 。 
因此 ， 我 们 使 用 这 种 机 制 可 以 对 缓存 项 执行 清理 (删除 相关 的 资源 ) 或 者 跟踪 调试 等 操作 。 


ES 视频 教学 : 光盘 /videos/09/ 指 定 回调 函数 avi 长 度 : 11 分 名 


9.5.1 基础 知识 一 一 缓存 回调 函数 


为 了 能 够 指定 缓存 项 的 删除 回调 函数 ， 首 先 必须 使 用 Insert( 方 法 的 如 下 重 载 形式 添加 组 
存 项 。 
public void Insert(string key, object value, CacheDependency dependencies, 


DateTime absoluteExpiration, TimeSpan slidingExpiration, CacheItemPriority 
priority, CacheItemRemovedCallback onRemoveCallback); 


这 里 的 onRemoveCallback 参数 是 一 个 CacheItemRemovedCallback 类 型 的 委托 ， 它 的 值 应 
该 是 一 个 不 带 括号 的 函数 名 称 (例如 ， 应 该 是 callback 而 不 是 callbackO)。 
如 下 所 示 为 这 个 回调 函数 的 声明 格式 : 


mn > 
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delegate void CacheItemRemovedCallback (string key object value, 
CacheItemRemovedReason reason); 


可 以 看 到 ，ASP.NET 会 向 回调 函数 中 传递 被 删除 缓存 项 的 键 名 和 值 ， 以 及 删除 该 项 的 原 
因 。 其 中 ，reason 参数 表示 删除 的 原因 ， 它 是 一 个 CacheItemRemovedReason 类 型 的 枚 举 值 ， 
可 选项 有 如 下 几 个 。 

@。 DependencyChanged: 从 缓存 移 除 该 项 的 原因 是 与 之 关联 的 缓存 依赖 项 已 更 改 。 

@ ”Expired: 从 缓存 移 除 该 项 的 原因 是 它 已 过 期 。 

@ ”Removed: 该 项 是 通过 指定 键 名 并 调用 Remove() 方 法 从 缓存 中 移 除 的 。 

@ Underused: 之 所 以 从 缓存 中 移 除 该 项 ， 是 因为 系统 要 通过 移 除 该 项 来 释放 内 存 。 

例如 ， 下 面 的 代码 演示 了 回调 函数 的 使 用 方法 。 

// 定 义 一 个 委托 类 型 

CacheItemRemovedCallback onRemove = null; 

// 回 调 函数 

public void RemovedCallBack (string key, object value，CacheItemRemovedReason 

reason) 

| // 在 这 里 根据 删除 原因 进行 相应 的 处 理 


} 
public void SetCacheItem() 


tL! 

// 指 定 委托 的 回调 函数 

onRemove = new CacheItemRemovedCallback (this.RemovedCallBack); 

// 使 用 Insert () 方法 添加 一 个 缓存 项 ， 并 指定 回调 函数 

if (this.Context.Cache["key"] == null) 

this .Context .Cache.Insert ("key", "value", null, 
DateTime.Now.AddSeconds (60), TimeSpan.Zero, 
CacheItemPriority.High, 
onRemove 
); 
} 


9.5.2 ”实例 描述 


软件 设计 借鉴 了 硬件 设计 中 引入 缓存 机 制 以 改善 整个 系统 的 性 能 , 尤其 是 对 于 一 个 数据 库 
驱动 的 Web 应 用 程序 而 言 ， 缓 存 的 利用 是 不 可 或 缺 的 。 毕 竟 ， 数 据 库 查 询 可 能 是 整个 Web 站 
点 中 调用 最 频繁 但 同时 又 是 执行 最 缓慢 的 操作 之 一 , 我 们 不 能 让 它 老 迈 的 双 腿 拖 住 我 们 前 进 的 
征程 。 缓 存 机 制 正 是 解决 这 一 缺陷 的 加 速 器 。 

下 面 让 我 们 一 起 来 看 看 Web 服务 中 应 用 程序 缓存 的 强大 功能 ， 以 及 了 解 它 是 如 何 通过 回 
调 函数 来 跟踪 缓存 的 删除 。 


9.5.3 ”实例 应 用 


【 例 9-3】 为 删除 缓存 项 指定 回调 函数 


< 全 mm 


< 服务 开发 学 习 实 录 


(1) 在 Visual Studio 中 为 实例 创建 一 个 Web 服务 文件 。 
(2) 使 用 如 下 代码 添加 对 命名 空间 的 引用 。 
using System.I0O; 


using System.Collections; 


using System.Web.Caching; 


(3) 首先 添加 一 个 AddCacheItems0 方 法 ， 它 向 Cache 对 象 中 添加 了 3 个 缓存 项 ， 并 指定 
了 不 同 的 过 期 时 间 。 当 从 Cache 对 象 中 删除 它们 时 ， 都 会 调用 onRemoveCacheItem0) 方 法 ， 具 
体 实现 代码 如 下 所 示 : 

// 向 cache 对 象 中 添加 几 个 数据 项 ， 然 后 返回 这 些 数 据 项 的 名 称 和 值 


[WebMethod (Description = "向 cache 对 象 中 添加 几 个 数据 项 ， 然 后 返回 这 些 数 据 项 的 名 称 和 值 


")] 
public string[] RddcacheItems () 


{ 


// 创 建 代理 对 象 实 例 
onRemoveCacheItem = new CacheItemRemovedCallback (this.RemoveCallBack); 
if (this.Context.Cache["Expired30s"] == null) 


this.Context.Cache.Insert ("Expired30s", 
"该 缓存 项 在 30 秒 后 失效 "， nul1， 
DateTime.Now.AddSeconds (30), TimeSpan.Zero, 
CacheItemPriority.High, 
onRemoveCacheItem 
) 7 
// 添 加 一 个 依赖 于 Expried30s 的 缓存 项 
if (this.Context.Cache["DependExpired30s"] == null) 
{ 
string[] dependencyKey = new string[1]; 
dependencyKey[0] = "Expired30s"; 
CacheDependency dependency = new CacheDependency (null, dependencyKey); 
this .Context .Cache.Insert( 
"DenpendExpired30s", 
"该 缓存 项 依赖 于 Expired30s"， 
dependency, 
DateTime.Now.AddMinutes (30), TimeSpan.Zero, 
CacheItemPriority.High, 
onRemoveCacheItem 
5 
} 
// 添 加 一 个 依赖 于 文件 的 缓存 项 
if (this.Context.Cache["DependFile"] == null) 
E 
CacheDependency dependency = new CacheDependency("e:\\log.txt"); 
this.Context.Cache.Insert ("DenpendFile"，, "该 缓存 项 依赖 于 文件 E:\\log.txt， 
当 文 件 发 生变 化 时 它 将 被 删除 。"， 


dependency, 


mm 过 >> 
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DateTime.Now.AddMinutes (30), TimeSpan.Zero, 
CacheItemPriority.High, 
onRemoveCacheItem 
); 
} 
// 返 回 cache 对 象 中 的 数据 项 
string[] items = new String[this-Context-Cache-Count]7 
int i = 0; 
foreach (DictionaryEntry objItem in this.Context.Cache) 
{ 
string strName = objItem.Key.ToString(); 
items[i++] = strName + ":" + this.Context.Cache[strName]; 
} 
return items; 


} 


(4) 创建 AddCacheItems() 方 法 所 需 的 回调 函数 onRemoveCacheItem。 在 这 个 回调 函数 中 
将 记录 每 一 次 的 删除 操作 ， 实 现代 码 如 下 所 示 : 
private CacheItemRemovedCallback onRemoveCacheItem = null; 


// 定 义 一 个 回调 函数 ， 在 这 个 回调 函数 中 将 记录 每 一 次 删除 操作 ， 这 些 记录 将 保存 在 Application 对 
象 中 
private void RemoveCallBack (string name, object thevalue, 
CacheItemRemovedReason reson) 
{ 

ArrayList logs; 


if (Application["logs"] == null) 
logs = new ArrayList(); 
else 


logs = (ArrayList) (Application["logs"]); 
string log = "你 在 [" + DateTime .Now.ToString() + "] 时 执行 了 删除 操作 。 删 除 目标 : 
("+ name + ": " + thevalue +")， 删除 原因 : " + reson.ToString(); 
logs.Add (log); 
Application["logs"] = logs; 
3 


(5) 编写 一 个 GetLogs() 方 法 获取 回调 函数 的 删除 操作 ， 实 现代 码 如 下 所 示 : 


// 获 取 回调 函数 记录 的 删除 操作 
[WebMethod (Description = "获取 回调 函数 记录 的 删除 操作 ") ] 
public string[] GetLogs () 
{ 
if (Application["logs"] == null) 
return null; 
ArrayList logs = (ArrayList) (Application["logs"]); 
string[] thelogs = new string[logs.Count]; 
for (int i = 0; i < logs.Count; i++) thelogs[i] = (string) (logs[i]); 
return thelogs; 


< 人 mm 


(6) 接 下 来 创建 一 个 SaveLogs() 方 法 把 删除 记录 保存 到 一 个 外 部 文件 中 ， 实 现代 码 如 下 
所 示 : 


// 把 删除 记录 保存 到 文件 1o0g .txt 中 
[WebMethod (Description = "把 删除 的 记录 保存 到 1o0g .txt 中 ， 这 将 导致 DependFile 缓存 项 
的 删除 ") ] 
public string SaveLogs () 
{ 
ArrayList logs = (ArrayList) (Application["logs"]); 
if (1ogs == null) return "没有 删除 记录 "; 
StreamWriter sw = new StreamWriter("e:\\log.txt", true); 
for (int i = 0; i < logs.Count; i++) 
{ 
sw.WriteLine((string)1logs [i]); 
} 
sw.Close(); 
return "删除 记录 保存 成 功 "; 
} 


(7) 至 此 ， 关 于 Web 服务 的 操作 缓存 项 的 代码 就 编写 完成 了 。 


9.5.4 ”运行 结果 


现在 通过 浏览 器 来 测试 上 面 创建 的 Web 服务 ， 如 图 9-15 所 示 为 打开 后 的 页 面 。 


\ 图 9-15 浏览 Web 服务 


这 里 先 对 AddCacheItems() 方 法 进行 测试 ， 单 击 该 链接 并 单 击 【 调 用 】 按 钮 会 看 到 该 方法 
返回 Cache 对 象 中 的 所 有 缓存 项 ， 如 图 9-16 所 示 。 


9-16 ”保存 在 Cache 对 象 中 的 缓存 项 


Esc > 
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从 图 9-16 中 可 以 看 到 ， 除 了 保存 的 3 个 缓存 项 外 ，ASP.NET 还 在 Cache 对 象 中 保存 了 其 
他 很 多 数据 。 


下 面 调用 GetLogs() 方 法 查看 onRemoveCacheItem() 方 法 记录 的 删除 操作 。 因 为 程序 开始 时 ， 
没有 缓存 项 被 删除 ， 所 以 返回 结果 为 空 ， 如 图 9-17 所 示 。 


图 9-17 没有 缓存 项 被 删除 时 


此 时 ， 如 果 等 待 30 秒 之 后 ， 这 时 第 1 个 缓存 项 ExpiredAfter30s 将 会 被 从 Cache 对 象 中 删 
除 ，ASPNET 将 会 自动 调用 指定 的 onRemoveCacheItem() 方 法 。 又 因为 DependExpiredAfter30s 
缓存 项 依赖 于 Expired30s 缓存 项 ,所 以 ExpiredAfter30s 的 删除 将 会 导致 DependExpiredAfter30s 
也 被 删除 ， 如 图 9-18 所 示 。 


Srix 
EE F 山 - 入 本- IR 册 - 加- 


hapr/ /tempori.org/"> 
(Expired30%， 这 人 各 基 在 30 匠 后 


F12011-4-1 17:09;40 所 全 了 贡院 亿 作 。 伙 入 日 标 ，(DenpendExpired30s， 让 有 项 
DependencyChanged /strmg> 


图 9-18 ”ExpiredAfter30s 导致 的 DependExpiredAfter30s 被 删除 


从 图 9-18 中 可 以 看 到 ，ExpiredAfter30s 缓存 项 的 删除 原因 是 Expired， 即 过 了 有 效 期 限 ; 
DependExpiredAfter30s 缓存 项 的 删除 原因 是 DependencyChanged， 即 它 所 依赖 的 对 象 发 生 了 
改变 。 

最 后 ,为 了 观察 DependFile 缓存 项 被 删除 的 情况 ， 在 这 里 可 以 调用 SaveLogs0) 方 法 。 该 方 
法 将 会 把 onRemoveCacheItem 记录 的 删除 操作 保存 到 文件 “E:log.txt” 中 ， 而 DependFile 缓存 
项 又 依赖 于 这 个 文件 。 所 以 这 个 方法 将 会 导致 DenpendFile 缓存 项 被 删除 ， 如 图 9-19 所 示 为 调 
用 SaveLogs0 方 法 的 结 


图 9-19 调用 SaveLogs() 方 法 结果 


在 调用 SaveLogs0 方 法 之 后 ， 如 果 用 户 再 次 调用 GetLogs() 方 法 将 会 看 到 如 图 9-20 所 示 的 
结果 。 


< 和 


© 站 


/mL Schema" ns 
PF TNR WR do, G0 


mat me (DenpendExpired30s 让 看 


Ce a 
/anayo 


9-20 ”保存 文件 导致 了 DenpendFile 缓存 项 被 删除 


从 图 9-20 中 可 以 看 到 ， 对 文件 的 保存 操作 导致 了 DependFile 缓存 项 的 删除 ， 它 的 删除 原 
因为 DependencyChanged。 


9.5.5 ”实例 分 析 


Sr 


本 实例 的 重点 是 使 用 缓存 项 的 删除 回调 函数 来 跟踪 缓存 项 的 删除 时 间 以 及 删除 原因 。 

在 本 实例 中 ， 虽 然 创建 了 3 个 缓存 项 ， 但 是 只 需要 定义 一 个 回调 函数 即 可 。 第 1 个 缓存 项 
为 国定 过 期 时 间 ， 即 30 秒 ; 第 2 个 缓存 项 的 过 期 时 间 依 赖 于 第 1 个 缓存 项 ; 第 3 个 缓存 项 的 
过 期 时 间 依 赖 于 一 个 外 部 文件 。 


9.6 使 用 缓存 时 的 注意 事项 


虽然 缓存 在 ASP.NET 中 的 使 用 非常 简单 ， 而 且 缓存 能 有 效 提高 程序 的 性 能 。 但 是 ， 这 并 
不 意味 着 缓存 使 用 得 越 多 就 越 好 。 

因为 ， 如 果 我 们 在 缓存 中 保存 了 太 多 的 信息 ， 那 么 ASP.NET 将 会 自动 丢弃 一 些 多 余 的 信 
息 。 这 与 使 用 会 话 状态 (在 超时 之 前 ， 信 息 可 以 一 直 保留 ) 或 者 应 用 程序 状态 (信息 在 应 用 程序 的 


生命 周期 中 一 直 保留 ) 不 同 。 因 此 在 缓存 过 满 时 ， 可 能 会 挤 出 其 他 更 重要 的 信息 ， 也 会 降低 应 
用 程序 缓存 的 效率 和 性 能 
可 见 ， 缓 存 是 一 把 双 刃 剑 ， 只 有 合理 使 用 才能 发 挥 作 用 。 本 节 我 们 就 来 了 解 一 些 使 用 缓存 
时 需要 注意 的 事项 。 
视频 教学 光盘 /videos/09/ 使 用 缓存 的 注意 事项 .avi 图 长 度 : 6 分 名 
使 用 缓存 的 主要 目的 就 是 为 了 提高 应 用 程序 的 性 能 ， 在 使 用 缓存 时 用 户 需 要 注意 以 下 
事项 。 


(1) 不 要 缓存 大 量 的 数据 。 因 为 缓存 是 在 内 存 中 保存 数据 ， 如 果 数 据 量 很 大 将 会 占据 大 量 
的 内 存 ， 这 将 会 严重 影响 程序 的 性 能 。 
(2) 用 户 应 该 只 缓存 那些 变化 不 太 频繁 的 数据 。 因 为 缓存 的 主要 作用 就 是 把 数据 暂时 保存 


m= > 
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在 内 存 中 ， 当 下 次 请 求 这 些 数据 时 ， 就 不 用 再 次 执行 创建 过 程 ， 这 样 就 可 以 提高 性 能 。 因 此 ， 
如 果 数 据 频繁 地 变化 ， 则 内 存 中 缓存 的 数据 就 会 频繁 地 失效 ， 就 无 法 起 到 应 有 的 作用 ， 反 而 会 
降低 程序 的 性 能 。 

(3) 尽量 不 要 缓存 特定 于 用 户 的 数据 。 因 为 如 果 用 户 数量 很 大 ,将 会 造成 缓存 的 数据 量 很 
大 ， 这 将 得 不 偿 失 。 而 且 ， 缓存 特定 于 用 户 的 私有 数据 有 可 能 会 造成 安全 隐患 。 

(4) 用 户 不 仅 可 以 缓存 应 用 程序 的 响应 数据 ， 也 可 以 缓存 其 他 的 应 用 程序 数据 或 者 资源 ， 
以 此 来 提高 性 能 。 例 如 ， 用 户 可 以 缓存 一 个 数据 集 对 象 ， 这 样 后 续 的 查询 就 可 以 直接 在 内 存 中 
进行 ， 这 可 以 明显 地 提高 程序 的 性 能 。 

(5) 如 果 用 户 能 够 预料 到 下 一 步 操作 所 需 的 数据 ， 也 可 以 把 这 部 分 数据 缓存 。 例 如 ， 客 户 
要 查找 并 下 载 一 篇 文章 ， 在 查找 结束 后 就 可 以 提前 把 这 篇 文章 加 载 到 内 存 中 。 这 样 ， 当 客户 下 
载 时 ， 就 可 以 直接 从 内 存 中 获取 它 。 

(6) 用 户 在 客户 端 和 服务 器 端 都 可 以 使 用 缓存 。 例 如 ， 假 设 存 在 一 个 访问 数据 库 的 Web 
服务 ， 则 用 户 既 可 以 充分 利用 数据 库 服务 器 的 缓存 机 制 ， 也 可 以 在 Web 服务 中 使 用 缓存 ， 这 
样 当 遇 到 相同 的 调用 时 ， 就 可 以 直接 返回 结果 而 不 用 再 去 查询 数据 库 。 最 后 ， 还 可 以 在 客户 端 
把 Web 服务 的 返回 结果 缓存 ， 这 样 就 不 用 去 频繁 地 通过 网 络 来 调用 Web 服务 。 

(7) 在 使 用 缓存 时 ， 用 户 需要 注意 的 一 个 关键 问题 是 缓存 的 有 效 期 。 因 为 缓存 中 的 数据 不 
可 能 永远 有 效 ， 所 以 用 户 需要 确定 一 个 比较 合适 的 更 新 缓存 的 时 间 间 隔 。 

(8) 当 在 客户 端 使 用 缓存 时 ， 用 户 应 该 建立 一 种 通知 客户 端 数据 失效 的 机 制 。 这 可 以 通过 
在 返回 的 数据 中 包含 有 效 期 信息 来 实现 。 例 如 ,用户 可 以 在 SOAP 消息 中 添加 一 个 表示 数据 有 
效 期 的 字段 。 

(9) 因为 缓存 中 的 数据 经 常 发 生变 化 ， 所 以 用 户 一 定 不 要 依赖 于 缓存 中 的 数据 ， 而 是 要 随 
时 判断 缓存 中 是 否 存在 所 需 的 数据 ， 并 根据 判断 结果 进行 相应 的 处 理 。 


9.7 了 解 事务 的 并 发 机 制 


事务 是 工作 的 逻辑 单元 ， 一 个 事务 由 一 个 或 多 个 完成 一 组 相关 行为 的 语句 组 成 。 管 理事 务 
就 是 确保 这 一 组 语句 所 做 的 操作 要 么 完全 成 功 地 执行 ， 完 成 整个 工作 单元 的 操作 ; 要 么 一 点 也 
不 执行 。 

事务 通常 与 数据 库 的 关系 非常 密切 ， 因 此 下 面 结合 数据 库 来 对 事务 进行 解释 。 


和 视频 教学 ， 光盘 /videos/09/ 了 解 事务 的 并 发 机 制 .avi 人 @@ 基 度 :10 分 钟 


下 面 以 银行 转账 过 程 为 例 说 明 事务 的 特性 。 将 一 笔 资 金 从 一 个 账户 转移 到 另 一 个 账户 ， 对 
于 顾客 来 说 , 发 生 的 转账 只 是 一 个 运作 , 但 在 数据 库 系 统 中 是 由 转 出 和 转 入 等 几 个 操作 组 成 的 。 
显然 ， 这 些 操作 要 么 全 都 发 生 ， 要 么 由 于 出 错 而 全 不 发 生 ， 这 是 最 基本 的 一 点 。 

如 果 数 据 库 只 完成 了 部 分 操作 ， 比 方 说 只 执行 了 转 出 或 转 入 ， 那 么 就 有 可 能 出 现 某 个 账户 
上 平 白地 少 了 或 者 多 出 一 些 资金 的 情况 。 

所 以 ,需要 事务 机 制 来 保证 这 些 操作 序列 的 逻辑 整体 性 。 为 了 便于 从 形式 上 说 明 银行 转账 
问题 ， 我 们 假定 事务 采用 以 下 两 种 操作 来 访问 数据 。 


< 二 mm 


@ ”Read(x): 从 数据 库 发 送 数据 项 x 到 事务 工作 区 。 
@ Write(x): 从 事务 工作 区 把 数据 项 x 传 回 数据 库 。 
假如 , 现在 要 从 账户 AccountA 过 户 500 元 到 账户 AccountB, 可 用 下 列 形式 定义 转账 事务 : 


Read (AccountA); // 读 取 Accounta 的 资金 
AccountA=AccountA-500; // 改 变 Accounta 的 资金 ， 减 少 500 
Write (AccountA); // 显 示 Accounta 的 当前 余额 

Read (AccountB) // 读 取 AccountB 的 资金 
AccountB=AccountB+500; // 改 变 RccountB 的 资金 ， 增 加 500 
Write (AccountB); // 显 示 AccountB 的 资金 余额 


事务 的 主要 作用 就 是 保证 数据 库 的 完整 性 。 因 此 ， 从 保证 数据 库 完 整 性 出 发 ， 我 们 要 求 数 
据 库 管理 系统 维护 事务 的 几 个 性 质 : 原子 性 (Atomicity)、 一 致 性 (Consistency)、 隔 离 性 (solation)、 
持久 性 (Durability)， 简 称 为 ACID， 下面 分 别 对 它们 加 以 讲述 。 


人 嵌 子 性 


事务 的 原子 性 是 指 事 务 中 包含 的 所 有 操作 要 么 全 做 ， 要 么 全 不 做 。 只 有 在 所 有 的 语句 都 正 
确 完 成 的 情况 下 ， 事 务 才能 完成 并 把 结果 应 用 于 数据 库 。 也 就 是 说 : 事务 的 所 有 活动 在 数据 库 
中 要 么 全 部 反映 ， 要 么 全 部 不 反映 ， 以 保证 数据 库 是 一 致 的 。 

例如 ， 转 账 事务 在 Write(AccountA) 操 作 执 行 完 之 后 、Write(AccountB) 操 作 执行 之 前 ， 数 
据 库 反映 出 来 的 结果 为 : 账户 AccountA 少 了 500 元 ,而 账户 AccountB 还 未 增加 500 元 ,此 时 
“账户 AccountA 十 账户 AccountB ”的 总 额 少 了 500 元 。 所 以 事务 执行 到 某 个 时 刻 数据 库 是 不 
一 致 的 ， 但 是 事务 执行 完成 后 ， 这 个 暂时 的 内 部 不 一 致 状态 就 会 被 账户 AccountB 增加 500 元 
所 代替 。 

保证 原子 性 的 基本 思路 如 下 : 对 于 事务 要 执行 写 操作 的 数据 项 ， 数 据 库 系 统 会 在 磁盘 上 记 
录 其 旧 值 ， 如 果 事务 没有 完成 ， 旧 值 被 恢复 ， 好 像 事务 从 未 执行 过 。 

2. 一 致 性 

事务 开始 之 前 ， 数 据 库 处 于 一 致 性 的 状态 ， 事 务 结束 后 ， 数 据 库 必须 仍 处 于 一 致 性 状态 。 

以 转账 事务 为 例 ， 尽 管事 务 执行 完成 后 ， 账 户 AccountA 和 AccountB 的 状态 多 种 多 样 ,但 
一 致 性 要 求 事务 的 执行 不 应 改变 账户 AccountA 和 AccountB 的 总 额 , 即 转 入 和 转 出 应 该 是 平衡 
的 。 如 果 没 有 这 种 一 致 性 要 求 ， 转 账 过 程 中 就 会 发 生 钱 无 中 生 有 或 不 翼 而 飞 的 现象 。 事 务 应 该 
把 数据 库 从 一 个 一 致 状态 转换 到 另 一 个 一 致 状态 。 

3 隔离 性 


在 事务 的 处 理 过 程 中 暂时 不 一 致 的 数据 不 能 被 其 他 事务 应 用 ， 直 到 数据 再 次 一 致 。 换 句 话 
说 ， 当 事务 使 数据 不 一 致 时 ， 其 他 事务 将 不 能 访问 该 事务 中 不 一 致 的 数据 。 

例如 ， 转 账 事务 在 执行 完 Write(AccountA) 之 后 、 执 行 Write(AccountB) 之 前 ， 数 据 库 中 账 
户 AccountA 中 少 了 500 元 ,账户 AccountB 并 没有 增加 500 元 ， 此 时 是 不 一 致 的 。 如 果 另 外 一 
个 事务 基于 此 不 一 致 状态 开始 为 每 个 账户 结算 利息 的 话 , 那么 显然 银行 会 少 支付 由 500 元 产生 
的 利息 。 


>> 
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4. 持久 性 


一 个 事务 成 功 完成 后 ， 它 对 数据 库 的 改变 就 被 保护 起 来 ， 即 便 是 在 系统 遇 到 故障 的 情况 下 
也 不 会 丢失 。 例 如 ， 如 果 转 账 事务 执行 完毕 ， 意 味 着 资金 的 流转 已 经 发 生 了 ， 那 么 用 户 无 论 何 
时 都 应 该 能 够 对 此 加 以 验证 , 系统 就 必须 保证 出 现任 何 系统 故障 都 不 会 丢失 与 这 次 转账 相关 的 
数据 。 

事务 一 旦 发 生 任 何 问 题 ， 整 个 事务 就 重新 开始 。 数 据 库 也 返回 到 事务 开始 前 的 状态 。 所 
发 生 的 任何 行为 都 会 被 取消 ， 数 据 也 恢复 到 其 原始 状态 。 事 务 要 成 功 完成 的 话 ， 所 有 的 变化 
都 在 执行 。 在 整个 过 程 中 ,无 论 事务 是 否 完成 或 者 是 否 必须 重新 开始 ， 事 务 总 是 确保 数据 库 的 
完整 性 。 


9.8 为 Web 服务 启用 事务 功能 


通过 对 上 一 节 的 学 习 ， 我 们 了 解 了 事务 的 概念 以 及 它 的 4 个 特性 。 为 了 在 Web 服务 中 使 
用 事务 功能 ， 我 们 需要 为 Web 服务 方法 的 WebMthod 属性 添加 TransactionOption 选项 。 之 后 
事务 的 提交 与 回 滚 完全 由 ASP.NET 来 完成 ， 无 须 用 户 控制 。 

下 面 将 介绍 事务 的 具体 使 用 方法 。 


< 视频 教学 : 光盘 /videos/09/ 启 用 事务 功能 .avi 长 度 : 4 分 钟 


TransactionOption 选项 的 值 是 一 个 TransactionOption 类 型 的 枚 举 值 ， 这 些 值 位 于 
System.EnterpriseServices 命名 空间 。 

因此 ， 用 户 在 使 用 时 首先 需要 添加 对 System.EnterpriseServices 的 引用 。TransactionOption 
类 型 的 各 个 值 如 下 。 

@ Disabled: 禁用 事务 ， 表 示 方 法 不 在 事务 的 范围 内 运行 ， 这 是 该 选项 的 默认 值 。 

@ ”NotSupported: 表示 方法 不 支持 事务 功能 ， 将 在 没有 事务 的 情况 下 运行 。 

@ ”Required: 表示 方法 需要 在 事务 内 运行 ， 此 项 与 RequiredNew 选项 作用 相同 将 创建 一 

个 新 的 事务 。 
@ RequiresNew: 表示 方法 需要 新 的 事务 才能 运行 。 即 每 次 请 求 该 方法 时 ， 都 将 在 一 个 
新 创建 的 事务 内 运行 它 。 

@ 。 Supported: 表示 方法 支持 事务 ， 但 是 不 在 事务 的 范围 内 运行 。 

在 默认 情况 下 ，Web 服务 方法 是 禁用 事务 的 。 因 此 ， 如 果 决 定 在 Web 服务 中 使 用 事务 ， 
那么 Web 服务 的 方法 只 能 作为 事务 中 的 一 个 根 对 象 来 参与 事务 。 这 也 意味 着 ，Web 服务 方法 
可 能 会 调用 其 他 支持 事务 的 对 象 ， 但 是 它 本 身 不 会 作为 另 一 个 对 象 运行 事务 的 一 部 分 来 调用 。 
存在 这 种 限制 的 原因 是 由 于 HTTP 协议 是 无 状态 的 。 

由 此 产生 的 结果 是 ，TransactionOption 的 Required 和 RequiredNew 是 等 价 的 (都 声明 一 个 
运行 新 事务 的 RequiredNew 方法 )，Disabled、NotSupported 和 Supported 是 等 价 的 (都 将 禁用 
Web 服务 方法 的 事务 )。 

例如 ， 下 面 的 代码 指定 DeleteArticle0 方 法 需要 在 一 个 新 事务 中 运行 ， 并 且 该 方法 将 对 数 


< 告 一 


据 库 进行 操作 。 


[WebMethod (TransactionOption=TransactionOption.RequiresNew)] 
public int DeleteRArticle(int artID) 
{ 
// 指 定 一 个 标准 可 以 执行 的 so 语句 
string delsQL = "delete from articles where id=" + artID; 
// 指 定 一 个 不 存在 表 执 行 删除 操作 ， 因 此 它 将 产生 一 个 异常 
string errorDelSsQL = "delete from category where id=" + artID7 
// 指 定数 据 库 连接 字符 串 
SqlConnection con = new SqlConnection("server=.;user id=sa;database=cms"); 
// 准 备 执行 的 sdqlcommand 对 象 
SqlCommand deleteCmd = new SqlCommand(delsQL, con) 7 
SqlCommand ErrorCmd = new SqlCommand (errorDe1SQL，con) 7 
// 连 接 到 数据 库 
deleteCmd.Connection.Open(); 
// 执 行 删除 命令 
deleteCmd.ExecuteNonQuery () 7 
// 执 行 不 存在 的 删除 操作 ， 将 会 产生 异常 并 导致 事务 回 滚 ， 因 此 上 面 的 删除 操作 也 被 回 深 
int cmdResult = ErrorCmd.ExecuteNonQuery (); 
// 关 闭 数据 库 连接 
con.Close(); 
return cmdResult; 


} 

上 面 的 DeleteArticle() 方 法 因为 使 用 TransactionOption 选项 启用 了 事务 ， 所 以 当 该 方法 的 
执行 过 程 产生 任何 异常 时 ，ASP.NET 都 会 自动 终止 事务 。 同 时 ， 该 方法 的 所 有 操作 都 位 于 一 
个 事务 内 ， 所 以 当 出 现 异 常 时， 该 方法 内 的 所 有 操作 都 将 被 取消 和 回 滚 。 除 非 该 方法 内 的 所 有 
操作 都 正常 完成 ， 此 时 该 方法 对 应 的 事务 才 会 被 提示 ， 对 数据 库 的 改变 才 会 真正 产生 作用 。 


9.9 常见 问题 解答 


9.9.1 设置 Web 服务 的 响应 时 间 和 数据 传输 长 度 


设置 Web 服务 的 响应 时 间 和 数据 传输 长 度 。 
网 络 课堂 : http://bbs.itzcn.com/thread-15744-1-1.html 


我 用 ASP.NET 架设 了 一 个 Web 服务 项 目 ， 当 上 传 1 万 多 条 记录 时 ， 如 果 超 过 1 分 钟 ， 则 
出 现 “ 操 作 超时 ”的 提示 ， 如 果 上 传 2 万 条 记录 ， 会 提示 超出 最 大 长 度 。 

请 问 ， 该 如 何 设 置 Web 服务 的 响应 时 间 和 传输 最 大 长 度 ? 

【解决 办 法 】 

你 可 以 为 Web 方法 的 CacheDuration 选项 设置 一 个 比较 大 的 值 ， 它 以 秒 为 单位 。 另 外 ， 也 
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可 以 在 站 点 的 Web.config 中 进行 修改 ， 这 部 分 代码 如 下 所 示 : 
<configuration> 
<system.web> 


<httpRuntime maxRequestLength= "100000 " executionTimeout= "9000 " /> 
</system.web> 
</configuration> 


9.9.2 ”Web 服务 中 更 新 缓存 问题 


Web 服务 中 更 新 缓存 问题 。 
网 络 课堂 : http:/Wbbs.itzcn.comythread-15745-1-1.html 


我 用 CacheDuration 设置 了 缓存 ， 但 如 果 在 这 个 时 间 内 有 内 容 进 行 了 更 新 。 那 用 户 应 该 如 
何 获取 最 新 的 数据 ? 
【解决 办 法 】 
你 的 问题 可 以 通过 缓存 的 依赖 项 来 解决 。 下 面 给 出 一 段 示例 代码 : 
[WebMethod (CacheDuration=600) ] 
public string HelloWorld() { 
HttpContext.Current.Cache.Insert ("test", string.Empty); 
HttpContext .Current.Response.AddCacheItemDependency ("test"); 


return DateTime.Now.ToString(); 


} 


这 样 一 来 ， 如 果 在 其 他 地 方 更 新 数据 了 ， 那 么 该 方法 需要 进行 更 新 时 只 需 使 用 “Http 
Context.Current.Cache.Remove("test"); ”语句 即 可 ; 然后 这 个 HelloWorld0 方 法 会 重新 执行 ， 产 
生 新 的 缓存 。 


9.10 习 题 


一 、 填 空 题 

(1) 在 ASPNET 中 可 以 通过 来 缓存 页 面 中 的 一 部 分 内 容 。 

(2) Cache 类 属于 命名 空间 , 在 Web 服务 中 可 以 通过 来 访问 这 个 类 
的 对 象 实例 。 

(3) 应 用 程序 缓存 的 生命 周期 依赖 于 

(4) 在 Cache 类 中 使 用 属性 返回 当前 应 用 程序 中 缓存 项 的 数量 ， 使 用 

方法 删除 一 个 缓存 项 。 
(5) 在 Insert0 方 法 中 使 用 参数 指定 缓存 项 的 删除 回调 函数 。 


(6) 假设 有 一 个 名 为 Removeltem 的 回调 函数 ， 补 充 下 面 的 代码 ， 使 它 具有 高 优先 级 ， 并 


< 车 一 


带 有 回调 函数 。 


CacheItemRemovedCallback CallBack = new 


CacheItemRemovedCallback (RemoveItem) 7 


this.Context.Cache.Insert ("key", "value", null, 
DateTime.Now.AddSeconds (60), TimeSpan.Zero, 


学 


ks 


(7) 事务 必须 具备 的 四 个 属性 为 : 原子 性 、 一 致 性 、 和 持久 性 。 

(8) 如 果 将 TransactionOption 选项 的 值 设置 为 来 指定 Web 服务 方法 需要 新 的 
事务 才能 运行 。 

二 、 选 择 题 

(1) 我 们 要 缓存 一 个 页 面 的 内 容 应 该 使 用 


(2) 


(3) 


(4) 


(5) 


(9) 


DD 


A. 整 页 缓存 B. 单 页 缓存 C. 输出 缓存 D. 部 分 页 缓存 
下 面 关 于 输出 缓存 的 描述 不 正确 的 是 

A， 能 够 提高 页 面 的 响应 速度 

B. 超过 指定 时 间 之 后 自动 过 期 ， 不 用 手动 控制 

C. 在 Web 服务 中 使 用 CacheDuration 选项 来 开启 

D. 可 以 缓存 任何 类 型 的 数据 ， 例 如 DataSet 

假设 要 创建 一 个 缓存 1 分 钟 的 输出 缓存 项 ， 应 该 使 用 代码 。 
A. CacheDuration=1 B. CacheDuration=6000 

C. CacheDuration=600 D. CacheDuration=60 

下 面 关于 输出 缓存 与 应 用 程序 缓存 的 描述 ， 不 正确 的 是 。 

A， 前 者 存储 Web 服务 方法 的 结果 ， 后 者 可 以 存储 任何 类 型 的 信息 
B. 前 者 使 用 CacheDuration 开启 ， 后 者 使 用 Cache 类 开启 

C. 前 者 的 缓存 时 间 不 可 调整 ， 后 者 可 手动 控制 

D. 两 者 都 可 以 使 用 缓存 项 的 回调 函数 

如 果 要 向 应 用 程序 中 添加 一 个 缓存 项 ， 下 面 代码 不 正确 的 是 
A. this.Context.Cache["Time"] = "2011-11-11" 

B. this.Context.Cache.Insert("Time ", "2011-11-11"): 

C. this.Context.Cache.Add("Time ", "2011-11-11"); 

D. this.Context.Cache.Insert("Size"， "1000", null, DateTime.Now.AddMinutes(10), 
TimeSpan.Zero): 

在 使 用 priority 参数 配置 缓存 的 优先 级 时 ， 它 的 默认 值 是 
A. BelowNormal B. Normal 

C. AboveNormal D. High 

要 在 Web 服务 中 使 用 事务 功能 ， 必 须 引用 的 命名 空间 是 

A. System.EnterpriseServices 


B. System.Web.Transaction 
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C. System.Web.Caching 
D. System.Data.Transaction 
三 、 上 机 练习 
上 机 练习 1: 利用 输出 缓存 保存 数据 。 
本 次 上 机 练习 要 求 读者 使 用 Web 服务 的 输出 缓存 来 完成 。 实 现 将 一 个 7 位 数字 缓存 1 天 ， 
然后 在 页 面 调用 并 显示 这 些 数 字 。 最 终 运行 效果 如 图 9-21 所 示 。 


七 星 彩 号 码 预测 - Windows Internet Explorer 


区 - 园 - 品 晤 页面 吵 ” 安全) 


天 天 彩票 网 祝 你 早日 实现 发 财 梦 
AtESNF 和 @09948 


温 声 提示 ， 彩 票 有 风险 ， 入 行 要 并 慎 ! 


图 9-21 运行 效果 


< 人 
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内 容 摘 要 : 

Web 服务 使 用 了 非常 灵活 的 开放 性 的 标准 ， 所 以 Web 服务 成 为 在 网 络 中 应 用 程序 之 间 通 
信 的 一 种 绝 佳 的 通信 机 制 。 我 们 可 以 通过 它 向 客户 端 提供 各 种 功能 。 但 是 ， 由 于 Web 服务 的 
标准 的 限制 和 Web 服务 需要 支持 各 种 类 型 的 客户 端 ， 所 以 我 们 可 以 使 用 任意 的 方式 来 访问 这 
些 Web 服务 。 所 以 ,保护 Web 服务 的 安全 是 一 件 非常 具有 挑战 性 的 事情 。 

由 于 安全 性 涉及 诸多 方面 ， 而 且 SOAP 规范 中 并 没有 提 及 安全 性 这 一 事实 ， 所 以 有 些 人 可 
能 会 认为 安全 性 与 Web 服务 无 关 。 这 种 观点 是 不 正确 的 。 

当然 ， 也 不 能 低估 了 ASPNET 中 的 Web 服务 ， 因 为 我 们 可 以 采取 许多 措施 来 创建 安全 的 
Web 服务 。 

本 章 将 深入 了 解 ASPNET 中 关于 Web 服务 的 身份 验证 、 授 权 机 制 ， 以 及 使 用 SOAP 实现 
安全 通信 的 技术 ， 以 保护 Web 服务 的 安全 。 

学 习 目标 : 

@ 了 解 什么 是 安全 机 制 
熟悉 ASPNET Web 服务 中 的 安全 体系 
熟悉 Windows 下 的 各 种 身份 验证 方式 
熟练 使 用 Windows 身份 验证 机 制 
熟练 使 用 ASPNET 提供 的 Form 验证 机 制 
熟练 使 用 自 定义 SOAP 报头 来 提高 应 用 程序 安全 


10.1 了 解 Web 服务 安全 机 制 


如 何 保护 Web 服务 从 来 没有 被 官方 着 重 强调 过 ， 但 是 Web 服务 肯定 是 要 发 布 在 Internet 
中 的 ， 肯 定 是 要 由 用 户 来 访问 的 。 而 我 们 不 可 能 保证 所 有 访问 Web 服务 的 用 户 都 是 遵 规 守 甜 
的 合法 用 户 ， 所 以 Web 服务 可 能 会 受到 各 种 各 样 的 攻击 ， 比 如 DDOS 攻击 、 非 法 用 户 试 图 进 
入 、 未 授权 的 用 户 访问 等 。 

不 仅仅 在 Internet 中 的 Web 服务 需要 承担 很 大 的 风险 ， 在 内 部 网 上 发 布 的 Web 服务 也 同 
样 可 能 会 受到 各 种 各 样 的 外 部 攻击 。 

所 以 ， 我们 有 必要 基于 各 个 方面 的 考虑 来 设计 Web 服务 。 


各 视频 教学 : 光盘 /videos/10/ 了 解 Web 服务 安全 机 制 avi 长度: 18 分 名 


设计 一 个 高 安全 性 的 Web 服务 是 非常 有 必要 的 ， 所 以 我 们 不 得 不 从 各 个 方面 来 考虑 Web 
服务 的 安全 性 。 下 面 就 来 了 解 一 下 Web 服务 的 安全 机 制 。 


10.1.1 基础 知识 一 一 什么 是 安全 机 制 


安全 机 制 是 在 一 个 公共 场合 中 保护 合法 权益 不 受 侵犯 的 一 些 手段 。 
在 应 用 程序 中 , 我 们 可 以 通过 保护 私有 属性 和 通过 特定 的 身份 验证 来 允许 指定 的 用 户 合法 
地 访问 一 些 公有 属性 的 机 制 以 保证 应 用 程序 安全 。 这 个 身份 可 以 是 一 组 用 户 名 和 密码 ， 也 可 以 
是 一 个 密 钥 或 一 个 证 书 等 。 
在 Intemet 中 使 用 安全 机 制 来 保护 应 用 程序 安全 的 时 候 ， 有 一 些 名 词 需要 了 解 , 如 下 所 示 。 
@ 身份 证 : 客户 端 用户 的 身份 证 明 ， 可 能 是 一 组 用 户 名 和 密码 ， 也 可 能 是 一 个 证 书 或 一 
个 密 钥 等 。 
@ 验证 : 验证 是 一 种 对 客户 端 用 户 的 权限 进行 检验 的 机 制 。 它 可 以 接收 用 户 的 身份 证 ， 
并 进行 用 户 权限 的 检验 。 
@ ”权限 : 通常 是 一 个 确认 的 信息 ， 标 示 着 该 用 户 在 应 用 程序 中 的 可 操作 范围 。 
@ ”授权 : 授权 是 服务 器 授予 某 用 户 对 某 种 资源 的 访问 权限 的 一 种 处 理 过 程 。 
@ ”加 密 : 加 密 是 信息 发 送 端 和 信息 接收 端 协商 制定 的 一 种 规则 。 我 们 可 以 使 用 它 来 进行 
数据 转换 ， 以 确保 数据 的 实际 信息 只 能 由 信息 发 送 端 和 信息 接收 端 知道 。 


10.1.2 ”基础 知识 一 一 Web 服务 的 安全 体系 


Web 服务 运行 在 Web 服务 器 中 , 而 Web 服务 器 需要 有 服务 器 系统 的 支持 。 所 以 在 Internet 
中 ， 对 于 整个 Web 服务 的 安全 性 设计 需要 考虑 以 下 三 个 级 别 。 

@ 平台 /传输 级 (点 对 点 ) 安 全 性 

@ ”应 用 程序 级 ( 自 定义 ) 安 全 性 


= >> 
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@ 消息 级 ( 端 对 端 ) 安 全 性 
当然 这 三 种 级 别 的 安全 性 是 针对 Web 服务 的 三 个 不 同方 向 的 设计 ， 它 们 三 个 必须 同时 配 
合 使 用 才能 够 保证 Web 服务 应 用 程序 是 一 个 高 安全 性 的 应 用 程序 。 
1. 平台 /传输 级 (点 对 点 ) 安 全 性 
台 / 传 输 级 安全 性 是 指 Internet 中 的 两 个 平台 之 间 的 安全 传输 通道 ， 它 连接 Web 服务 的 
客户 端 和 服务 器 端 ， 它 在 平台 (如 Windows、Linux、UNIX 等 ) 之 间 进 行 点 对 点 的 安全 过 滤 。 如 
图 10-1 所 示 为 平台 /传输 级 安全 性 的 传输 示意 图 。 


Web 
服务 器 


| 安全 传输 管道] 基 | 


口 


图 10-1 平台 /传输 级 安全 性 的 传输 示意 图 


以 Windows 平台 下 的 ASP.NET 应 用 程序 为 例 ， 该 平台 下 的 应 用 程序 安全 性 可 以 设置 下 面 
三 个 方面 的 配置 。 

@ ”Web 服务 器 IIS 提供 了 最 基本 、 集 成 和 证 书 身份 验证 。 

@ ASPNET Web 服务 可 以 继承 某 些 ASP.NET 身份 验证 和 授权 功能 。 

@ ”还 可 以 使 用 SSL 或 IPSec 提供 消息 的 完整 性 和 机 密 性 。 

平台 /传输 级 安全 模型 简单 明了 ， 除 了 Web 服务 ， 它 还 可 以 用 于 许多 其 他 的 应 用 程序 解决 
方案 。 在 这 些 应 用 程序 解决 方案 中 ， 平 台 /传输 级 安全 模型 都 可 以 严格 地 控制 传输 机 制 和 终结 
点 的 配置 。 

不 过 ， 这 种 方式 的 安全 模型 还 有 一 些 不 太 完 美的 地 方 。 因 为 它 基 于 平台 的 特性 ， 所 以 它 的 
安全 性 取决 于 基本 的 平台 、 网 络 传输 机 制 和 安全 性 服务 提供 程序 ， 并 与 它们 紧密 集成 。 

2. 应 用 程序 级 ( 自 定义 ) 安 全 性 

应 用 程序 级 安全 性 是 指 由 应 用 程序 负责 提供 的 安全 性 机 制 , 所 有 的 安全 性 控制 全 部 由 应 用 
程序 自己 定义 。 

例如 可 以 在 Web 服务 应 用 程序 中 使 用 自 定义 的 SOAP 消息 头 传递 用 户 和 凭证， 以便 根据 每 
个 Web 服务 请 求 对 用 户 进行 身份 验证 。 

3. 消息 级 ( 端 对 端 ) 安 全 性 

消息 级 安全 性 是 指 由 网 络 中 发 送 的 消息 本 身 来 控制 数据 的 安全 性 。 

消息 级 安全 性 是 一 种 使 用 非常 灵活 而 且 功能 非常 强大 的 方法 。GXA 提案 使 用 的 就 是 这 种 
盘 法 : 


< 洁 一 


消息 级 安全 性 的 示意 图 如 图 10-2 所 示 。 


10-2 ”消息 级 安全 性 示意 图 


技术 文档 GXA 


GXA: 全 球 XML 体系 结构 。 
可 以 将 GXA 定义 为 一 种 框架 ， 一 系列 的 协议 ， 一 个 规范 集 ， 一 个 视窗 或 是 一 种 标准 的 
起 始 。 但 是 事实 上 ，GXA 是 上 述 方面 的 综合 。 
定义 GXA 的 一 个 最 简单 的 方法 就 是 将 W3C 创建 的 规范 统一 封装 起 来 .当前 所 有 的 WS-I 
规范 都 来 自 GXA。 
GXA 协议 集 是 建立 在 一 系列 的 共享 设计 原则 之 上 的 。 这 些 设计 原则 为 所 有 新 生 的 或 是 
已 存在 的 GXA 协议 起 着 指导 方针 的 作用 。 
@ 分散 和 联盟 : 由 于 XML Web 服务 在 应 用 程序 的 消息 机 制 中 没有 集中 管理 功能 ， 
因此 它 是 分 散 的 。 而 在 联盟 中 Web 服务 使 用 命名 空间 和 URI 机制 保 证 层次 结构 的 
@ 模块 性 : GXA 框架 协议 能 利用 GXA 框架 的 构造 基础 : SOAP。 针 对 具体 问题 , GXA 
能 分 解 为 许多 构建 模块 有 针对 性 地 处 理 每 个 问题 。 
@ 以 XML 为 数据 模型 的 基础 GXA 采用 广泛 使 用 的 XML1.0 标准 作为 数据 模型 的 


基础 。 
@ ”传输 中 立 ，GXA 在 SOAP 信息 交换 层 被 完全 规范 ， 并 不 依赖 于 用 于 通信 的 传输 层 
的 语法 和 语义 。 


@ 应 用 领域 中 立 : GXA 协议 表达 的 是 一 种 规范 ， 这 种 规范 用 于 解决 跨越 许多 应 用 领 
域 的 广泛 的 问题 。 由 于 GXA 协议 并 没有 涉及 特殊 的 应 用 需求 ， 我 们 就 可 以 用 它们 
作为 固定 网 络 服 务 器 框架 的 基准 ， 同 时 允许 应 用 的 一 些 具体 细节 。 

GXA 的 魅力 所 在 就 是 它 为 网 络 服务 提供 了 一 个 在 精确 定义 以 及 安全 模式 下 进行 操作 的 

基础 ， 同 时 是 特殊 应 用 设计 的 负载 并 完全 独立 于 这 些 协 议 本 身 。 

SOAP 消息 传递 的 增强 功能 提供 了 消息 完整 性 、 消 息 机 密 性 以 及 单 次 消息 身份 验证 等 校 验 
机 制 。 我 们 可 以 使 用 在 SOAP 报头 中 传递 的 安全 令 牌 提供 客户 端 用 户 的 身份 验证 功能 ; 也 可 以 
使 用 数字 签名 来 提供 安全 通信 的 功能 ， 以 确保 消息 的 完整 性 ， 还 可 以 使 用 XML 加 密 来 保证 
SOAP 消息 的 机 密 性 。 


m= >> 
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总 体 来 说 ， 消 息 级 安全 性 主要 有 以 下 优点 。 

可 以 不 依赖 于 基本 传输 。 

支持 异类 安全 体系 结构 。 

提供 端 对 端的 安全 性 并 通过 中 间 应 用 程序 节点 提供 消息 路 由 。 
支持 多 种 加 密 技 术 。 

支持 不 可 否认 性 。 


10.1.3 ”基础 知识 一 一 与 Web 服务 有 关 的 安全 选项 


在 ASP.NET 应 用 程序 中 ，Web 服务 支持 多 种 类 型 的 安全 设置 选项 ， 分 别 是 : 
@ SSL 
简要 验证 
集成 Windows 验证 
客户 授权 证 书 验证 
自 定义 验证 
基本 验证 、 简 要 验证 和 集成 Windows 验证 方法 作为 一 项 服务 由 IIS 提供 给 Web 服务 。 
ASP.NET 提供 了 表单 、 护 照 验证 和 SOAP 技术 ，ASP.NET 和 Web 服务 通过 使 用 验证 提供 者 来 
处 理 这 种 验证 。 


10.1.4 ”Web 服务 安全 层 


如 果 要 保护 一 个 Web 服务 ， 我 们 可 以 从 三 个 层次 着 手 ， 如 表 10-1 所 示 。 
表 10-1 Web 服务 的 安全 层 


层 安全 类 型 说 明 
应 用 层 HTTP 身份 验证 、 密 码 技术 _| 程序 开发 人 员 可 以 在 这 里 使 用 代码 进行 一 些 验证 


TCP 层 | ssL | 可 以 进行 一 些 少量 的 编程 工作 


SSL 
区 该 层 对 编程 人 员 是 透明 的 ， 但 只 限于 Windows 平台 和 
人 P 层 卫 安全 
UNIX 平台 


下 面 从 低 到 高 依次 了 解 这 些 安全 层 。 
1. IP 层 安全 


卫 安全 是 一 种 Internet 标准 ， 用 于 保护 在 IP 层 传输 的 Internet 数据 流量 。 卫 安全 在 IP 层 
操作 ， 因 此 对 编程 人 员 来 说 是 透明 的 。 

可 以 通过 向 人 P 包 添 加 两 个 题 头 来 操作 该 协议 ， 其 中 一 个 题 头 用 于 身份 验证 ， 另 一 个 用 于 
数据 加 密 。 

身份 验证 机 制 是 为 了 保证 数据 的 接收 者 确信 信息 的 发 送 者 是 一 个 真实 合法 的 信息 发 送 者 。 
而 且 ， 加 密 技术 可 以 确保 数据 的 机 密 性 ， 其 方法 是 以 预定 的 方式 加 密 编码 被 保护 的 数据 。 

卫 安全 机 制 允 许 几乎 所 有 的 安全 机 制 完成 身份 验证 和 加 密 工 作 , 但 是 这 可 能 会 产生 各 平台 
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间 因 为 相互 竞争 而 导致 的 不 兼容 。 所 以 ， 基 于 这 种 模型 的 安全 机 制 比较 适合 于 基于 Web 应 用 
程序 的 LAN 和 WAN， 所 有 参加 通信 的 机 器 都 被 一 个 具有 统一 标准 的 系统 所 控制 。 
不 过 , IP 安全 的 另 一 个 局 限 性 是 它 没有 为 编程 人 员 提 供 一 个 标准 的 方法 ， 以 使 他 们 确保 自 
己 的 应 用 程序 仅 能 运行 在 基于 IP 安全 的 系统 之 上 。 也 就 是 说 ，IP 层 可 以 很 简单 地 被 不 法 用 户 
2. TCP 层 安全 


TCP 层 安全 通常 以 使 用 SSL(Secure Sockets Layer， 安 全 套 接 层 ) 而 知名 。SSL 可 以 为 HTTP 
提供 透明 的 加 密 机 制 。 

TCP 层 安 全 是 一 个 被 广泛 依赖 的 安全 机 制 , 我 们 可 以 使 用 它 来 确保 基于 HTTP 的 通信 的 完 

因为 ASP.NET Web 服务 是 基于 HTTP 之 上 的 SOAP 协议 的 ,所 以 它 也 必须 使 用 SSL 来 保 
护 数据 的 完整 性 。 

3. 应 用 层 安 全 


.NET Framework 也 提供 了 一 种 基于 HTTP 身份 验证 的 机 制 。 HTTP 身份 验证 的 机 制 是 一 种 
基于 用 户 名 和 密码 的 身份 验证 机 制 。 也 就 是 说 可 以 设置 在 使 用 HTTP 协议 访问 应 用 程序 的 时 候 
需要 用 户 使 用 用 户 名 和 密码 来 访问 这 个 Web 服务 器 。 

5 虽然 HTTP 可 以 设置 需要 用 户 名 和 密码 来 访问 该 服务 器 ， 但 是 一 般 来 说 ，Web 服 
组 未 | 。 务 器 都 会 开启 匿名 登录 的 功能 ， 所 以 一 般 访问 Web 服务 器 的 时 候 不 需要 输入 用 户 
名 和 密码 。 


在 前 面 我 们 说 过 ， 为 了 自身 加 密 的 需要 ，HTTP 层 也 需要 依赖 于 SSL。 

要 保护 Web 数据 不 被 拦截 窃取 ， 可 以 编写 安全 通道 收发 器 ， 用 来 处 理 数据 的 安全 问题 。 
另外 保护 Web 服务 数据 完整 性 的 另外 一 种 方法 是 使 用 加 密 技术 ， 这 样 可 以 使 非法 用 户 即 使 得 
到 数据 也 不 能 知道 数据 的 实际 内 容 。 


10.2 ”使 用 Windows 验证 来 限制 用 户 访问 


在 Web 出 现 的 早期 , 我 们 对 网 络 中 用 户 访问 的 控制 都 是 由 系统 账户 控制 和 管理 。 随 着 Web 
功能 的 日 益 强大 ， 用 户 权限 验证 方式 也 多 种 多 样 ， 但 是 使 用 Windows 验证 仍然 是 一 个 不 可 或 
缺 的 方案 。 


只 视频 教学 : 光盘 /videos/10/Windows 验证 .avi @@ 长 度 : 13 分钟 
10.2.1 基础 知识 一 一 集成 Windows 验证 

当 请 求 一 个 使 用 集成 Windows 验证 的 Web 站 点 时 ，Web 服务 器 域名 和 一 个 标记 将 返回 到 
服务 器 (这 个 标记 包括 使 用 散 列 算 法 加 密 过 的 密码 和 用 户 名 等 信息 )。 接 着 Web 服务 器 发 送 用 户 
名 、 域 名 等 信息 给 域名 控制 器 ， 域 名 控制 器 将 验证 身份 的 合法 性 并 给 Web 服务 器 (如 IS) 返 回 
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一 个 响应 信息 。 
1. 集成 Windows 验证 的 优点 


前 面 也 提 到 过 ，Web 应 用 程序 可 以 使 用 多 种 身份 验证 方法 。 其 中 使 用 集成 Windows 验证 
有 诸多 优点 ， 如 下 所 示 。 

@ ”容易 实现 : Windows 验证 基于 Windows 系统 的 安全 机 制 ， 使 用 起 来 不 需要 太 多 额外 
的 技术 。 

@ 能 完美 地 被 IS 支持 : IIS 和 Windows 系统 同 出 一 家 ， 当 然 在 结合 性 上 更 加 紧密 。 使 
用 IIS 实现 Windows 验证 的 功能 非常 简单 。 

@ ”无 过 高 要 求 : 配置 起 来 非常 简单 ， 我 们 只 需要 在 Windows 视窗 界面 中 单 击 几 下 鼠标 
即 可 完成 配置 。 

@ ”密码 从 不 通过 网 络 发 送 : Windows 验证 会 在 客户 端 将 用 户 密码 使 用 散 列 算法 进行 加 
密 ， 因 此 保证 了 密码 的 安全 性 。 


2. 集成 Windows 验证 的 缺点 


任何 事物 都 有 利 有 疯 ， 技 术 也 一 样 。 集 成 Windows 验证 主要 有 以 下 几 个 缺点 。 

@ 浏览 器 兼容 性 不 是 很 好 : 它 可 以 被 正 等 最 为 主流 的 浏览 器 所 支持 ， 但 是 其 他 的 一 些 
浏览 器 对 Windows 验证 的 支持 还 不 是 很 好 。 

@ 集成 Windows 验证 不 能 应 用 在 代理 服务 器 上 。 

@ 可 能 面临 服务 器 端口 被 占用 的 问题 : 附加 的 TCP 端口 可 能 会 被 防火 墙 拦 下 ， 所 以 我 
们 要 使 用 集成 Windows 验证 ， 还 需要 在 防火 墙 上 打开 指定 的 附加 端口 。 

@ 不 能 靠 自 定义 权限 使 用 此 验证 : 在 我 们 使 用 基本 验证 时 ， 身 份 证 将 一 直 与 Windows 
账号 数据 库 相 对 比 。 我 们 不 可 能 以 自 定义 权限 来 比较 身份 证 ， 因 为 它 使 用 了 Windows 
用 户 账号 来 做 这 些 事情 。 


3. 何 时 使 用 Windows 验证 


集成 Windows 验证 是 微软 对 HITP 协议 的 扩展 。 它 作为 特有 的 功能 被 添加 到 IIS 服务 器 
和 正 浏览 器 中 。 

因为 Windows 验证 对 浏览 器 的 支持 不 是 很 好 ， 所 以 在 Web 应 用 程序 中 ,集成 Windows 验 
证 通常 被 应 用 在 企业 内 部 网 中 ， 也 好 进行 客户 端 统一 。 

由 于 Windows 验证 是 发 生 在 客户 端的 ， 也 就 是 说 基本 上 Windows 验证 和 服务 器 端 没有 关 
系 ， 所 以 在 Web 服务 器 中 使 用 集成 Windows 验证 的 方式 比较 安全 。 但 是 ， 在 服务 器 端 必须 同 
时 为 该 验证 打开 附加 的 TCP 端口 ， 而 打开 额外 的 端口 可 能 会 给 企业 内 部 网 络 带 来 安全 隐患 ， 
很 多 网 络 管理 员 并 不 喜欢 这 么 做 。 

所 以 ， 我 们 在 是 否 使 用 Windows 验证 的 问题 上 要 仔细 考虑 以 便 进 行 合理 的 设计 。 


10.2.2 ”实例 描述 


在 Windows 服务 器 系统 中 ，IIS 对 Windows 验证 方式 提供 了 很 好 的 支持 ， 我 们 可 以 在 IS 
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中 很 轻松 地 对 Web 站 点 启用 Windows 验证 模式 。 
本 实例 ,我 们 就 在 Windows 2003 系统 的 HS 服务 器 中 启动 Windows 验证 ， 对 Web 服务 进 
行 第 一 道 的 安全 验证 。 


10.2.3 ”实例 应 用 


【 例 10-1】 使 用 Windows 验证 来 限制 用 户 访问 
(1) 使 用 Visual Studio 2010 开发 工具 创建 一 个 Web 项 目 ， 并 在 其 中 创建 一 个 Web 服务 ， 
命名 为 WSCounter。 
(2) 在 WSCounter 中 创建 一 个 名 为 Add 的 Web 方法 ， 执 行 加 法 操作 。WSCounter 类 的 代 
码 如 下 所 示 : 


using System; 
using System.Collections.Generic; 
using System.Linqg; 
using System.Web; 
using System.Web.Services; 
namespace WebServices 
{ 
/// <summary> 
/// WSCounter 的 摘要 说 明 
/// </summary> 
[WebService (Namespace = "http://tempuri.org/")] 
[WebServiceBinding (ConformsTo = WsiProfiles.BasicProfilel 1)] 
[System.ComponentModel .ToolboxItem(false)] 
// 若 要 人 允许 使 用 ASP .NET AJAX 从 脚本 中 调用 此 web 服务， 请 取消 对 下 行 的 注释 。 
// [System.Web.Script.Services.SscriptService] 
public class WSCounter : System.Web.Services.WebService 
{ 
[WebMethod] 
public decimal Add(decimal a, decimal b) 
此 
return a De 


} 


} 
(3) 此 时 由 于 安全 级 别 的 限制 ，Web 服务 方法 还 不 能 被 远程 计算 机 的 浏览 器 访问 测试 。 下 
面 修改 web.config 文件 ， 添 加 相应 的 配置 代码 。 
这 里 需要 在 configuration 节点 下 的 system.web 节点 中 添加 一 段 配置 信息 ， 如 下 所 示 : 
<configuration> 
<! 一 其 他 配置 省 略 --> 
<system.web> 


<! 一 其 他 配置 省 略 --> 


<webServices> 


<protocols> 
<add name="HttpGet"/> 
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<add name="HttpPost"/> 
</protocols> 
</webServices> 
</system.web> 
</configuration> 
(4) 生成 该 Web 项 目 ， 并 将 其 发 布 成 一 个 Web 站 点 。 
(5) 将 该 Web 站 点 上 传 到 Web 服务 器 默认 站 点 的 根 目录 中 。 这 里 Web 服务 器 使 用 的 是 
Windows 2003 系统 和 IIS 6.0 的 Web 服务 器 程序 。 
(6) 接 下 来 需要 在 IS 中 启用 Windows 验证 方式 。 首 先 需要 依次 展开 Internet 信息 服务 左 
侧 窗口 中 的 【本 地 计算 机 】 节 点 下 的 【网 站 】 节 点 ， 然 后 右键 单 击 【 默 认 网 站 】 节 点 ， 在 弹出 
的 快捷 菜单 中 选择 【属性 】 命 令 ， 打 开 【 默 认 网 站 属性 】 对 话 框 。 我 们 需要 设置 该 网 站 的 安 
全 性 ， 所 以 切换 到 【目录 安全 性 】 选 项 卡 ， 如 图 10-3 所 示 。 
在 【目录 安全 性 】 选 项 卡 中 可 以 看 到 IS 提供 了 三 大 类 的 安全 性 验证 方法 ， 其 中 包括 身份 
验证 和 访问 控制 、IP 地 址 和 域名 限制 、 安 全 通信 。 
(7) 在 【目录 安全 性 】 选 项 卡 中 单 击 【 身 份 验证 和 访问 控制 】 选 项 组 中 的 【编辑 】 按 钮 ， 
打开 【身份 验证 方法 】 对 话 框 ， 如 图 10-4 所 示 。 


| | zswr 7 器。 | 主 H 录 | 。 文档 [三 月 用 莉 名 六 月 的 一 一 一 一 一 一 一 一 一 一 
目录 安全 性 wm | BE | er mr 名 沪 月 使 用 下 列 Windows 用 户 帐 户 : 
身 内 入 WE 和 访问 控制 
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安全 信 
| 38 SR PRM gous 


wv | 厂 .ET Tassport 身价 驻 证 四 
的 可 中) 矿 
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3 mm |_EF% | mm 取 汉 得 助 m 
10-3 【目录 安全 性 】 选 项 卡 10-4 【身份 验证 方法 】 对 话 框 


(8) 在 【身份 验证 方法 】 对 话 框 中 取消 对 所 有 复 选 框 的 选择 ， 然 后 选中 【集成 Windows 
身份 验证 】 复 选 框 ， 就 启用 了 对 该 Web 站 点 的 Windows 验证 模式 。 
(9) 单 击 【 确 定 】 按 钮 保存 设置 。 


10.2.4 ”运行 结果 


前 面 已 经 将 Web 服务 发 布 到 Windows 2003 系统 的 IIS 中， 我们 可 以 直接 在 客户 端 使 用 浏 
览 器 对 该 Web 服务 进行 测试 。 

打开 Internet Explorer 8 浏览 器 ， 使 用 服务 器 卫 访问 Web 服务 (比如 这 里 的 路 径 为 
http://192.168.0.12/WSCounter.asmx) 。 访 问 该 路 径 以 后 ， 系 统 就 会 自动 弹出 一 个 【连接 到 
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192.168.0.12】 对 话 框 ， 如 图 10-5 所 示 。 
在 这 里 需要 输入 服务 器 系统 中 的 一 组 用 户 名 和 密码 ， 如 果 输 入 错误 ,将 会 要 求 重 新 输入 用 
户 名 和 密码 ， 如 图 10-6 所 示 。 
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10-5 【连接 到 192.168.0.12】 对 话 框 10-6 重新 登录 


当 输 入 一 组 在 服务 器 中 存在 的 合法 的 用 户 名 时 ， 系 统 就 会 登录 成 功 ， 打 开 相 应 的 页 面 ， 如 
图 10-7 所 示 。 
接 下 来 就 可 以 测试 该 Web 服务 方法 了 ， 如 图 10-8 和 图 10-9 所 示 。 
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图 10-7 登录 成 功 图 10-8 ”Web 服务 方法 Add 


5 如 果 没有 在 第 3 步 对 web.config 文件 的 配置 ， 这 里 测试 的 时 候 就 不 会 显示 输入 参 
| 提示 | 数 的 表单 ， 而 是 一 个 “The test form is only available for requests from the local 
machine.” 的 提示 。 
http://192. 168. 0. 12/WSCounter. asax/Add - Windows Internet Explorer 


O° ee 192. 168.0.12. 
会 收成 天 。 狗 http-//192 188 0 12/s 


<?xml version="1.0" encoding="utf-8" ?> 
<decimal xmins="http:/ /tempuri.org/">5.5</decimal> 


图 10-9 Web 服务 方法 Add 执行 结果 
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10.2.5 “实例 分 析 


ne 


本 实例 , 首先 使 用 VS2010 创建 一 个 Web 项 目 , 并 添加 一 个 用 于 执行 数学 运算 操作 的 Web 
服务 ， 然 后 在 该 Web 服务 中 添加 相应 的 Web 服务 方法 。 将 该 Web 项 目 发 布 到 Web 服务 器 上 ， 
配置 IIS 的 安全 验证 方法 为 “集成 Windows 身份 验证 ” 即 可 启用 该 Web 站 点 的 Windows 身份 
验证 功能 。 这 时 ， 再 来 访问 Web 服务 时 就 需要 使 用 Windows 服务 器 中 存在 的 合法 用 户 了 。 


10.3 ”使 用 表单 验证 进行 权限 过 滤 


当 Web 服务 有 非常 多 的 用 户 量 ， 而 且 需 要 关心 Web 服务 系统 的 安全 性 和 可 伸缩 性 时 ， 使 
用 表单 验证 来 实现 用 户 身份 认证 将 是 一 个 不 错 的 选择 。 

表单 验证 功能 是 完全 使 用 自己 定义 的 数据 库 和 验证 方法 来 进行 的 用 户 权限 验证 。 由 于 我 们 
使 用 的 是 完全 自 定义 的 方法 ， 所 以 可 以 自由 地 控制 验证 过 程 中 的 细节 问题 。 

上 视频 教学 ;光盘 /videosy/10/ 表 单 验证 avi @Ok 度 : 5 分 名 

表单 验证 允许 采用 自 定义 权限 的 方法 来 验证 用 户 。 表 单 验证 是 完全 自 定义 的 ， 并 且 提 供 了 
内 置 功能 来 管理 Cookie， 全权 负责 有 关 加 密 、 解 密 、 验 证 的 复杂 事项 。 当 用 户 未 被 授权 或 验证 
失败 时 ， 可 以 把 用 户 转 送 到 注册 界面 或 登录 界面 中 。 

当 请 求 一 个 使 用 表单 验证 的 Web 站 点 时 , Web 服务 器 会 把 请 求 发 送 到 ASP.NET 运行 时 组 
件 ，ASP.NET 运行 时 组 件 将 会 检查 Web 请 求 是 否 包 含 一 个 与 服务 器 端 相 对 应 的 Cookie 信息 。 
如 果 这 个 Cookie 在 Web 请 求 里 存在 ， 那 么 ASP.NET 运行 时 组 件 将 会 把 请 求 传送 到 Web 服务 
页 面 。 如 果 Cookie 不 存在 ， 那 么 ASPNET 运行 时 组 件 将 把 Web 请 求 发 送 到 web.config 文件 
中 定义 的 注册 页 面 。 

表单 验证 是 当今 站 点 使 用 的 非常 流行 的 验证 方法 , 表单 验证 提高 了 以 各 种 权限 确认 身份 的 
灵活 性 。 基 于 各 种 需求 ， 可 以 有 选择 地 定制 一 些 验证 方法 来 实现 对 用 户 身份 的 验证 。 

1. 表单 验证 的 优点 

使 用 表单 验证 的 方式 实现 Web 服务 的 安全 性 验证 有 诸多 优点 ， 如 下 所 示 。 

@ 易于 实现 : 只 需要 简单 配置 web.config 文件 ， 并 使 用 数据 库 或 活动 目录 建立 一 个 验证 

机 制 即 可 。 

@ 无 特殊 要 求 : ASPNET 运行 时 组 件 可 以 自动 管理 Cookie。 
支持 自 定义 权限 : 可 以 自 定义 一 些 权限 来 实现 对 不 同 用 户 的 验证 。 

@ ”灵活 性 强 : 因为 表单 验证 完全 支持 自 定义 的 权限 验证 ， 所 以 这 给 我 们 程序 开发 人 员 提 

供 了 极 大 的 灵活 性 ， 使 我 们 更 容易 控制 整个 验证 过 程 。 


< 人 mm 


2. 表单 验证 的 不 足 
当然 ， 使 用 表单 验证 来 实现 Web 服务 的 安全 性 验证 机 制 也 不 是 最 完美 的 ， 总 体 来 说 还 有 
以 下 不 足 。 
@ 需要 Cookie: 表单 验证 使 用 Cookie 验证 用 户 ， 如 果 客 户 端 不 支持 Cookie， 那 么 验证 
机 制 将 会 失效 。 
@ 需要 耗费 更 多 的 服务 器 性 能 : 表单 验证 要 求 更 多 的 内 存 和 更 强 的 处 理 能 力 来 满足 服务 
器 的 性 能 需求 。 因 为 它 要 处 理 外 部 权限 ， 所 以 对 系统 的 性 能 有 较 高 的 要 求 。 


10.4 禁止 使 用 浏览 器 访问 Web 服务 


Web 服务 是 发 布 在 Intemet 上 的 。 默 认 情 况 下 ， 它 可 以 被 客户 端 以 HITP 方式 访问 。 

访问 一 个 Web 服务 可 以 使 用 POST、GET 和 SOAP 三 种 方式 。 一 般 来 说 ， 使 用 编程 方式 
请 求 Web 服务 时 都 是 使 用 SOAP 方式 ， 而 我 们 使 用 Web 浏览 器 请 求 Web 服务 时 是 GET 方式 
或 POST 方式 。 

某 些 时 候 ， 由 于 一 些 比较 保密 的 Web 服务 并 不 想 让 用 户 使 用 浏览 器 访问 ， 那 么 ， 就 可 以 
在 服务 器 端 设 置 禁用 浏览 器 访问 。 


4 
加 ， 视频 教学 : 光盘 /videos/10/ 禁 止 浏览 器 访问 .avi 图 长 度 :16 分钟 


10.4.1 ”基础 知识 一 一 禁用 GET、POST 请 求 


默认 情况 下 ，Web 服务 客户 端 可 以 使 用 以 下 三 个 方式 与 ASP.NET Web 服务 进行 通信 : 
HTTP GET、 HTTP POST 和 HTTP SOAP。 

如 果 Web 服务 不 需要 客户 端 使 用 浏览 器 进行 访问 ， 那 么 可 以 禁止 客户 端 使 用 HTTP 协议 
的 GET 方式 和 POST 方式 访问 Web 服务 。 

Web 服务 正常 运行 的 情况 下 ，Web 客户 端 不 需要 使 用 GET 和 POST 这 两 种 方式 。 如 果 禁 
用 这 两 个 协议 ， 可 以 很 大 程度 上 避免 出 现 潜在 的 安全 隐患 ， 使 Web 页 面 无 法 访问 在 防火 墙 后 
面 运 行 的 Web 服务 。 

当然 , 禁用 这 些 请 求 方式 意味 着 , 客户 端 将 无 法 使 用 Web 服务 测试 页 中 的 “调用 (Invoke)” 
按钮 来 测试 Web 服务 。 所 以 ， 必 须 开 发 一 个 简单 的 应 用 程序 并 添加 对 该 Web 服务 的 引用 ， 以 


执行 对 该 Web 服务 的 测试 工作 。 
' 无 论 在 Web 服务 中 禁用 或 启用 任何 一 种 访问 方式 ， 都 不 会 对 本 地 访问 构成 任何 
和 未 | 影响 


如 果 要 在 整个 服务 器 中 禁用 Web 服务 的 GET 和 POST 请 求 方式 ， 可 以 在 NET Framework 
中 的 machine.config 文件 中 配置 webServices 元 素 节点 ， 示 例 代 码 如 下 所 示 : 


<webServices> 


<protocols> 


mS >> 
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<add name="HttpSoap"/> 


<!-- <add name="HttpPost"/> --> 
<!-- <add name="HttpGet"/> --> 
<add name="Documentation"/> 
</protocols> 
</webServices> 


这 里 配置 了 客户 端 可 以 使 用 HTTP SOAP 方式 请 求 Web 服务 ， 以 及 可 以 访问 Web 服务 的 
文档 页 。 


\ 
0 [ webServices 节点 在 配置 文件 的 configuration 节点 下 的 system.web 节点 中 。 
示 


从 上 面 代码 中 可 以 看 到 webServices 元 素 中 的 protocols 元 素 中 可 以 使 用 add 元 素 配置 Web 
服务 请 求 的 访问 方式 ， 其 name 属性 可 以 设置 请 求 的 方式 ， 可 选 值 如 表 10-2 所 示 。 
表 10-2 add 元 素 的 name 属性 可 选 值 
值 说 明 
添加 HTTP GET 方式 。 传递 的 参数 被 追加 到 HTTP 请 求 URL 的 查询 字符 串 中 。 返 


回 


值 


被 当 作 简单 的 XML 文档 放 入 HTTP 响应 的 正文 中 

ed 添加 HTTP POST 方式 。 传递 的 方法 参数 被 放 在 HTTP 请 求 的 正文 中 。 返回 值 被 当做 简 
单 的 XML 文档 放 入 HTTP 响应 的 正文 中 

i 添加 HTTP So 方式 。SOAP 消息 在 HTTP 请 求 的 正文 中 发 送 。SOAP 响应 在 HTTP 
响应 的 正文 中 发 送 


添加 特殊 的 Documentation 方式 。 当 在 启用 了 此 方式 的 情况 下 直接 请 求 .asmx 页 时 ， 
ASPNET 运行 Helper 页 以 创建 HTML 文档 页 ， 该 文档 页 被 传递 到 提出 请 求 的 客户 端 


当然 ， 可 以 在 protocols 元 素 中 使 用 add 方法 添加 服务 器 允许 接受 的 请 求 方式 ， 也 可 以 


使 用 一 些 其 他 方法 移 除 或 清除 前 面 的 配置 。protocols 元 素 可 以 接受 的 3 个 子 元 素 及 其 说 明 如 
表 10-3 所 示 。 


Documentation 


表 10-3 protocols 元 素 的 子 元 素 


名 称 说 明 


添加 ASPNET Web 服务 可 用 来 接收 从 客户 端 发 送 的 请 求 数据 和 返回 响应 数据 的 指 
定 协议 。 默 认 情 况 下 ， 仅 启用 HttpSoap 和 Documentation 

从 配置 文件 的 范围 内 移 除 所 有 的 协议 

从 配置 文件 的 范围 内 移 除 用 来 处 理 请 求 和 响应 数据 的 指定 协议 


关于 这 三 个 配置 节点 ， 示 例 代 码 如 下 所 示 : 


<webServices> 


add 


Clear 


remove 


<protocols> 
<add name="protocolname"/> 


< 千 一 


<remove name="protocolname"/> 
<clear> 
</protocols> 


</webServices> 
@ ”如 果 要 配置 整个 服务 器 的 配置 选项 ， 可 以 配置 NET Framework 的 machine.config 


提示 文件 。 而 如 果 只 配置 Web 站 点 的 配置 选项 ， 可 以 在 该 站 点 的 web.config 文件 中 
配置 。 


10.4.2 ”实例 描述 


禁用 GET、POST 请 求 可 以 阻止 用 户 使 用 浏览 器 访问 Web 服务 。 这 样 在 一 定 程度 上 提升 
了 Web 服务 的 安全 性 。 
下 面 我 们 就 以 例 10-1 中 用 过 的 实例 来 演示 禁用 GET、POST 请 求 的 方法 。 


10.4.3 ”实例 应 用 


【 例 10-2】 禁止 使 用 浏览 器 访问 Web 服务 
(1) 先 来 修改 Web 服务 项 目的 配置 文件 ， 即 修改 webServices 节点 下 的 protocols 节点 中 
的 子 节 点 ， 只 添加 HttpSoap 和 Documentation 两 项 ， 而 移 除 其 余 的 两 项 ， 代 码 如 下 : 


<configuration> 
<! 一 其 他 配置 省 略 --> 
<system.web> 
<! 一 其 他 配置 省 略 --> 
<webServices> 
<protocols> 
<add name="HttpSoap"/> 
<remove name="HttpGet"/> 
<remove name="HttpPost"/> 
<add name="Documentation" /> 
</protocols> 
</webServices> 
</system.web> 
</configuration> 


(2) 重新 将 该 项 目 上 传 到 服务 器 上 的 Web 站 点 中 。 

(3) 重新 将 服务 器 中 的 Web 站 点 修改 为 默认 的 “启用 匿名 访问 ”， 如 图 10-10 所 示 。 

(4) 现在 需要 一 个 Windows 窗 体 作为 客户 端 来 调用 这 个 Web 服务 。 我 们 先 创建 一 个 
WinForm 项 目 ， 在 该 项 目 中 添加 到 Web 服务 http://192.168.0.12/WSCounter.asmx 的 服务 引用 ， 
命名 空间 名 称 为 ServiceCounter。 

(5) 创建 一 个 Windows 窗 体 项 ， 用 于 实现 加 法 计算 功能 。 窗 体 的 界面 如 图 10-11 所 示 。 


m= >> 
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10-10 ”启用 匿名 访问 10-11 窗 体 设计 效果 


(6) 需要 在 单 击 【执行 】 按 钮 时 ， 调 用 Web 服务 执行 加 法 操作 ， 所 以 这 里 在 【执行 】 按 
钮 的 单 击 事件 处 理 程序 里 添加 执行 代码 ， 如 下 所 示 : 


private void btnRun Click(object sender, EventArgs e) 


{ 


// 创 建 代理 类 对 象 
ServiceCounter.WSCounterSoapClient wsc = 
new ServiceCounter.WSCounterSoapClient (); 
decimal nl = decimal.Parse (this .txtN1 .Text) 7 
decimal n2 = decimal.Parse (this.txtN2 .Text) 7 
// 请 求 web 方法 ， 执 行 加 法 运算 
decimal result = wsc.Add(nl, n2); 
this.txtValue.Text = result.ToString(); 


10.4.4 ”运行 结果 


使 用 浏览 器 访问 Web 服务 http://192.168.0.12/WSCounter.asmx, 打开 Web 服务 的 文档 页 面 。 
接 下 来 进入 Web 方法 Add 的 页 面 ， 运 行 结果 如 图 10-12 所 示 。 
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WSCounter 
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Add 
Test 

The test form i only availoble for reqveats frem toe local machire 
soap 11 


The cloning is & sample SOaP 1.1 recuest and resoorse. The placeholders shown nced to be redlaced 
wih ctl Values, 

POST /NeCouacer.asns 3TTE/L 

aert 192.268.0.12 
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10-12 ”Web 服务 方法 Add 的 说 明 页 面 


< 


从 图 中 可 以 看 到 ，Web 服务 方法 Add 中 没有 测试 的 表单 了 。 而 是 出 现 一 行 提示 信息 “The 
test form is only available for requests from the local machine.”， 意 思 是 “测试 表单 只 对 服务 器 本 
机 有 效 ”， 也 就 是 说 在 远 端 计算 机 中 无 法 使 用 GET 请 求 或 者 POST 请 求 来 测试 Web 服务 。 

下 面 再 使 用 编写 的 测试 程序 来 验证 这 个 Web 方法 。 

运行 窗 体 应 用 程序 ， 分 别 在 前 两 个 文本 框 中 输入 一 个 数值 ， 然 后 单 击 【 执 行 】 按 钮 ， 稍 等 
加 法 运算 的 结果 就 会 被 显示 到 第 三 个 文本 框 中 ， 如 图 10-13 所 示 。 


10-13 ”使 用 测试 程序 测试 Web 服务 


10.4.5 ”实例 分 析 


ww 


本 实例 ， 首 先 修改 Web 服务 项 目的 配置 文件 ， 设 置 该 项 目 中 的 Web 服务 可 以 在 浏览 器 中 
查看 文档 ， 也 可 以 使 用 SOAP 方式 请 求 ， 但 是 不 能 使 用 POST 或 GET 方式 请 求 。 然 后 还 要 将 
服务 器 中 的 身份 验证 方式 改 为 允许 匿名 登录 . 最 后 编写 一 个 客户 测试 程序 使 用 SOAP 方式 测试 
Web 服务 。 


10.5 ”实现 自 定义 验证 的 Web 服务 


在 前 面 讲 过 ， 可 以 在 SOAP 消息 头 中 保存 少量 的 信息 ， 比 如 用 户 的 身份 验证 信息 等 。 

在 Web 服务 中 , 使 用 SoapHeader 方法 可 以 在 Web 服务 方法 的 请 求 中 增加 头 部 信息 ， 当 有 
人 调用 Web 服务 时 ， 可 以 通过 查询 这 个 请 求 的 头 部 信息 来 获取 该 访客 的 身份 ， 以 实现 系统 的 
身份 认证 功能 。 


得 
国 ， 视频 教学 : 光盘 /videos/10/ 自 定义 验证 .avi 国 长 度 : 13 分 钟 


10.5.1 基础 知识 一 一 自 定义 SOAP 报头 


为 了 使 应 用 程序 能 达到 一 定 的 目的 , 可 以 往 SOAP 报头 中 添加 一 些 自 定义 的 信息 。 比 如 可 
以 向 SOAP 报头 中 添加 指定 的 用 户 名 和 密码 变量 ， 然 后 就 可 以 在 Web 服务 中 读 取 该 SOAP 报 
头 信息 ， 做 出 一 些 相 应 的 验证 。 

SOAP 报头 提供 了 一 种 方法 ， 用 于 将 数据 传送 到 Web 服务 方法 中 ， 或 从 Web 服务 方法 中 
传递 数据 ， 并 且 该 数据 不 直接 与 Web 服务 方法 的 主要 功能 相关 。 


Ed)>> 
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在 Web 服务 中 使 用 SOAP 报头 的 方法 非常 简单 ， 主 要 分 为 以 下 几 步 。 


创建 一 个 从 SoapHeader 类 派生 的 自 定义 类 ， 用 于 封装 传 入 SOAP 标 头 的 数据 。 

将 一 个 自 定义 的 SoapHeader 类 对 象 作为 成 员 添 加 到 Web 服务 的 类 中 。 

在 Web 服务 类 中 的 Web 服务 方法 中 使 用 SoapHeader 属性 指定 自 定义 的 SOAP 标 头 的 
成 员 类 。 

在 Web 服务 方法 或 Web 服务 客户 端 中 访问 Web 服务 方法 的 时 候 将 SOAP 报头 对 象 作 
为 请 求 的 第 一 个 参数 传 入 。 


要 在 Web 服务 中 使 用 SOAP 报头 ， 需 要 实现 自己 的 SOAP 报头 类 。 自 定义 的 SOAP 报头 
类 需要 继承 SoapHeader 类 (该 类 在 命名 空间 System.Web.Services.Protocols 中 )。 示 例 代码 如 下 : 


public class MyHeader : SoapHeader 


{ 


} 


private string username; 
private string password; 
public string Username 
{ 
get{ return username; } 
set{ username = value; } 
| 
public string Password 
{ 
get{ return password; } 
set{ password = value; } 


当 有 了 一 个 SOAP 报头 类 以 后 ， 可 以 将 其 作为 一 个 公有 成 员 声 明 在 Web 服务 类 中 ， 如 下 


所 示 : 


public class WebServicel : System.Web.Services.WebService 


{ 


} 
这 和 


public MyHeader Header; 
// 其 他 代码 省 略 


二 


[Wel 
[So 
pub. 
{ 


有 可 以 在 Web 服务 类 中 的 Web 服务 方法 中 使 用 SoapHeader 来 指定 消息 头 所 封装 的 成 


代码 如 下 : 


bMethod] 
apHeader ("Header")] 
lic string Helloworld() 


return "Hel1lo World"; 


在 客户 端 声明 一 个 创建 的 SOAP 报头 类 的 实例 ， 然 后 在 调用 这 个 Web 服务 方法 的 时 候 将 
SOAP 报头 对 象 作为 Web 服务 方法 的 第 一 个 参数 传 入 , 就 可 以 在 Web 服务 中 直接 使 用 Web 服 
务 的 成 员 对 象 访问 设置 的 SOAP 报头 信息 了 。 


R03 


10.5.2 ”实例 描述 


在 Web 服务 的 几乎 所 有 验证 方法 中 ， 使 用 自 定义 SOAP 报头 的 方式 应 该 是 最 方便 ， 也 最 
容易 理解 和 实现 的 一 种 安全 验证 方法 。 

本 实例 ， 我 们 就 使 用 自 定义 SOAP 报头 的 方式 对 用 户 信息 查询 功能 进行 安全 验证 。 

这 个 例子 中 ， 在 SOAP 报头 中 保存 一 个 内 部 人 员 才 知道 的 口令 ， 如 果 用 户 请 求 对 上 口令 ， 
则 可 以 请 求 到 相应 的 结果 ， 否 则 抛 出 一 个 异常 信息 。 


10.5.3 ”实例 应 用 


【 例 10-3】 实现 自 定义 验证 的 Web 服务 

(1) 首先 在 Web 服务 项 目 中 创建 一 个 Web 服务 ， 命 名 为 WSUsers。 

(2) 这 里 需要 一 个 SOAP 报头 类 ， 用 于 封装 报头 信息 。 在 Web 服务 项 目 中 创建 一 个 类 ， 
命名 为 WSUsersKey， 该 类 继承 自 SoapHeader 类 。 在 该 类 中 只 需要 一 个 属性 Key， 用 于 封装 一 
个 只 有 内 部 人 员 才 知道 的 密 钥 。WSUsersKey 类 的 代码 如 下 所 示 : 

public class WSUsersKey : SoapHeader 

{ 

private string key; 
public string Key 
{ 
get { return key; } 
set { key = value; } 


} 


(3) Web 服务 WSUsers 用 于 查询 用 户 信息 。 用 户 信息 中 包括 用 户 名 、 电 话 号 码 和 邮箱 地 
址 等 信息 ， 所 以 我 们 要 设计 一 个 封装 用 户 信 息 的 实体 类 UserInfo， 代 码 如 下 : 


public class UserInfo 
{ 
private string username; 
private string phone; 
private string email; 
public string Username 
{ 
get { return username; } 
set { username = value; } 
| 
public string Phone 
{ 
get { return phone; } 
set { phone = value; } 
public string Email 
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get { return email; } 


set { email = value; } 


} 


(4) 接 下 来 ， 可 以 在 Web 服务 WSUsers 类 中 实现 业务 逻辑 。 
这 里 要 实现 一 个 根据 用 户 名 查询 用 户 信 息 的 Web 服务 方法 FileUserByName， 在 执行 该 方 


法 的 时 候 验 证 用 户 传 入 的 SOAP 消息 头 中 的 内 容 是 否 是 设 定 的 密 钥 “itzcn.com”。 如 果 是 ， 则 
执行 查询 并 返回 结果 ; 如 果 不 是 ， 则 抛 出 异常 信息 。 


WSUsers 类 的 实现 代码 如 下 所 示 : 


[WebService (Namespace = "http://tempuri.org/")] 
[WebServiceBinding (ConformsTo = WsiProfiles.BasicProfilel 1)] 
[System.ComponentModel .ToolboxItem (false)] 
public class WSUsers : System.Web.Services.WebService 
{ 
private WSUsersKey sKey; 
public WSUsersKey SKey 
{ 
get { return sKey; } 
set { sKey = value; } 
} 
[WebMethod] 
[SoapHeader ("SKey")] 
public UserInfo FineUserByName (string username) 
{ 
if (SKey.Key != "itzcn.com") 
{ 
throw new SoapException(); 
} 
UserInfo user = this.GetUser (username); 
return user; 
} 
Private UserInfo GetUser (string username) 
| 
// 模 拟 一 批 数据 供 客户 端 查询 
List<UserInfo> users = new List<UserInfo>(); 
users.Add (new UserInfo() { Username = " 祝 红 涛 "， Email = "zhht@itzcn.com", 
Phone = "0371-6548215"” }); 
users.Add (new UserInfo() { Username = " 赵 星 ", Email = "xing@itzcn.com", 
Phone = "010-12365485224"™ }); 
users.Add (new UserInfo() { Username = " 马 林 林 ", Email = "linlin@itzcn.com", 
Phone = "130254698775"™ }); 
users.Add (new UserInfo() { Username = " 段 少 治 "，Email =" 
duanshaozhi@itzcn.com", Phone = "1383812582"” }); 
foreach (var u in users) 
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if (u.Username == username) 
{ 
return u; 
} 
} 
return null; 


} 
完成 服务 器 端 后 ， 下 面 来 设计 客户 端的 Windows 程序 。 
(5) 在 客户 端 项 目 中 添加 对 该 Web 服务 的 服务 引用 。 
(6) 在 客户 端 项 目 中 创建 一 个 Windows 窗 体 。 该 窗 体 实现 输入 用 户 名 ， 查 询 出 该 用 户 的 
联系 方式 信息 。 窗 体 界面 的 设计 如 图 10-14 所 示 。 


用 户 信息 查看 


图 10-14 ”查询 用 户 信息 窗 体 


(7) 现在 要 做 的 工作 就 是 在 单 击 【 查 找 】 按 钮 时 ， 根 据 输入 的 “姓名 ”查询 用 户 信息 ， 并 
将 联系 方式 显示 到 窗 体 中 。 所 以 ，【 查 找 】 按 钮 的 单 击 事件 处 理 程序 代码 如 下 所 示 : 


private void btnsearch Click(object sender, EventArgs e) 
{ 
// 创 建 代理 类 对 象 
ServiceUsers.WSUsersSoapClient wsc = new ServiceUsers.WSUsersSoapClient (); 
// 创 建 soaP 报头 对 象 
ServiceUsers.WSUsersKey key = new ServiceUsers.WSUsersKey(); 
// 设 置 报头 对 象 内 容 
key.Key = "itzcn.com"; 
// 调 用 Web 服务 方法 ， 将 soaP 报头 对 象 作为 第 一 个 参数 传 入 


Var user = wsc.FineUserByName (key, this.txtUsername.Text); 


// 显 示 查 询 结果 
this.txtEmail.Text = user.Email; 
this .txtPhone.Text = user.Phone; 


10.5.4 ”运行 结果 


首先 使 用 浏览 器 访问 该 Web 服务 ， 执 行 以 后 ， 服 务 器 端 抛 出 异常 ， 结 果 如 图 10-15 所 示 。 
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10-15 请求 异常 


这 里 因为 在 使 用 Web 服务 方法 进行 权限 判断 时 ， 并 没有 为 其 传递 SOAP 消息 头 对 象 ， 而 
强行 使 用 抛 出 的 空 指针 异常 。 
”执行 以 后 浏览 器 默认 显示 的 是 HTTP 500 错误 , 设置 Internet 高 级 选项 中 取消 显示 
提示 友好 的 错误 信息 ， 就 会 显示 出 请 求 详细 的 错误 信息 。 
接 下 来 使 用 Windows 窗 体 应 用 程序 来 测试 这 个 Web 服务 。 在 “姓名 ”文本 框 中 输入 “ 段 
少 治 ”， 然 后 单 击 “ 查 找 ” 按 钮 ， 稍 等 ， 系 统 就 会 返回 相应 的 用 户 信息 ， 如 图 10-16 所 示 。 


可 可 可 


图 10-16 ”用户 信息 查看 


10.5.5 ”实例 分 析 


Bm 


本 实例 ， 首 先 创建 一 个 查询 用 户 信息 功能 的 Web 服务 WSUsers; 然后 创建 一 个 用 于 封装 
SOAP 报头 信息 的 类 WSUsersKey， 该 类 继承 自 SoapHeader 类 ; 接着 在 Web 服务 中 实现 相应 
的 查询 功能 ， 并 使 用 SoapHeader 方法 设置 Web 服务 方法 的 报头 对 象 ; 最 后 在 客户 端 声明 一 个 
刚才 创建 的 SOAP 报头 对 象 ， 并 作为 Web 服务 方法 的 第 一 个 参数 传递 给 Web 服务 ， 就 可 以 在 
服务 器 端 直接 访问 该 SOAP 报头 信息 了 。 


10.6 ”常见 问题 解答 


10.6.1 如 何 设计 安全 的 Web 服务 


如 何 设计 安全 的 Web 服务 ? 
网 络 课堂 : http://bbs.itzen.com/thread-15667-1-1.html 


< 


刚 学 了 Web 服务 , 发 现 使 用 起 来 非常 方便 , 但 是 它 也 像 Web 一 样 是 运行 在 HTTP 协议 之 
上 的 。 

我 们 在 使 用 Web 服务 的 时 候 如 何 才能 设计 出 安全 的 Web 服务 呢 ? 我 应 该 考虑 哪些 方 
面 呢 ? 

【解决 办 法 】 

设计 一 个 安全 的 Web 服务 需要 具有 如 下 思想 : 使 用 尝试 或 检验 过 的 设计 原则 来 设计 Web 
服务 项 目 ， 集 中 处 理 关键 区 域 。 

另外 还 要 注意 其 他 一 些 方面 , 包括 输入 验证 、 身 份 验证 、 授 权 、 配 置 管理 、 敏 感 数 据 保 护 、 
会 话 管理 、 密 码 系统 、 参 数 处理 、 异 常 管理 和 审核 与 日 志 记录 等 项 。 另 外 还 要 特别 注意 部 署 问 
题 ， 包 括 拓扑 、 网 络 基础 设施 、 安 全 策略 和 步骤 等 。 

可 能 这 些 项 非常 杂乱 ， 让 你 听 起 来 非常 头疼 。 不 过 你 可 以 从 前 到 后 慢 慢 地 了 解 ， 一 般 来 说 
也 很 少 有 人 能 一 下 子 学 会 所 有 的 东西 。 


10.6.2 ”Web 服务 的 安全 体系 


谁 来 给 我 简单 地 介绍 一 下 Web 服务 的 安全 体系 ? 
网 络 课堂 : http://bbs.itzen.com/thread-15668-1-1.html 


刚 学 Web 服务 ， 想 深入 了 解 一 下 关于 Web 服务 的 安全 性 问题 。 谁 来 给 我 简单 地 介绍 一 下 
Web 服务 的 安全 体系 ? 

【解决 办 法 】 

整个 Web 服务 的 安全 性 设计 需要 考虑 以 下 三 个 级 别 。 

(1) 平台 /传输 级 安全 性 。 

平台 /传输 级 安全 性 是 指 Internet 中 的 两 个 平台 之 间 的 安全 传输 通道 ， 它 连接 Web 服务 的 
客户 端 和 服务 器 端 ， 在 平台 与 平台 之 间 进 行 一 个 点 对 点 的 安全 过 滤 。 它 的 特点 是 简单 明了 。 除 
了 能 在 Web 服务 中 使 用 外 ， 还 可 以 应 用 在 其 他 各 种 Internet 互联 网 应 用 程序 解决 方案 中 。 它 的 

\ 缺点 是 和 应 用 平台 集成 过 于 紧密 ， 性 能 取决 于 基本 的 平台 、 网 络 传输 机 制 和 安全 性 服务 提供 

程序 。 

(2) 应 用 程序 级 安全 性 。 

应 用 程序 级 安全 性 是 指 由 应 用 程序 负责 提供 的 安全 性 机 制 , 所 有 的 安全 性 控制 全 部 由 应 用 
程序 自己 定义 。 

(3) 消息 级 安全 性 。 

消息 级 安全 性 是 指 由 网 络 中 发 送 的 消息 本 身 来 控制 数据 的 安全 性 ， 这 种 方式 非常 灵活 。 

另外 还 要 注意 的 一 点 是 ， 这 三 种 级 别 的 安全 性 是 针对 Web 服务 以 及 其 所 处 环境 相关 的 几 
个 方向 的 设计 ， 有 时 候 需 要 让 它们 三 个 协同 工作 才能 构建 完美 的 Web 服务 应 用 程序 。 
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10.7 习 题 


一 、 填 空 题 
(1) 与 Web 服务 有 关 的 安全 选项 中 支持 多 种 类 型 的 安全 选项 ， 包 括 SSL、 简 要 验证 、 
、 客 户 授 权证 书 验证 、 自 定义 验证 。 
(2) 在 Internet 中 ， 对 于 整个 Web 服务 的 安全 性 设计 需要 考虑 三 个 级 别 : 平台 /传输 级 (点 
对 点 ) 安 全 性 、 应 用 程序 级 ( 自 定 义 ) 安 全 性 和 
(3) IP 安 全 是 一 种 Internet 标准 ， 用 于 保护 在 层 传 输 的 Internet 数据 流量 。 
(4) 在 ASPNET Web 服务 应 用 程序 中 ， 基 本 验证 、 简 要 验证 和 集成 Windows 验证 方法 作 
为 一 项 服务 由 提供 给 Web 服务 。 
二 、 选 择 题 
(1) 下 面 说 法 错误 的 是 
A. 验证 是 一 种 对 客户 端 用 户 的 权限 进行 检验 的 机 制 。 它 可 以 接收 用 户 的 身份 证 ， 并 
进行 用 户 权 限 的 检验 。 
B.， 权限 通常 是 一 个 确认 的 信息 ， 标 示 着 该 用 户 在 应 用 程序 中 的 可 操作 范围 。 
C. 授权 是 客户 端 授予 本 机 用 户 访问 某 个 服务 器 站 点 中 的 资源 的 一 种 处 理 过 程 。 
D. 加 密 是 一 种 信息 发 送 端 和 信息 接收 端 协商 制定 的 一 种 规则 。 我 们 可 以 使 用 它 来 进 
行 数据 转换 ， 以 确保 数据 的 实际 信息 只 能 由 信息 发 送 端 和 信息 接收 端 知道 。 
(2) 下 列 选项 中 ， 不 是 使 用 表单 验证 的 优点 的 一 项 是 
。 匈 于 实现 
无 特殊 要 求 
.支持 自 定义 权限 
.可 以 使 用 操作 系统 中 的 账户 进行 验证 
E. 灵活 性 强 
(3) 默认 情况 下 ，Web 服务 客户 端 可 以 使 用 三 种 方式 与 ASP.NET Web 服务 进行 通信 ， 下 
面 不 属于 这 三 种 方式 中 的 一 项 是 
A. HTTP GET 
B. HTTP POST 
C. HTTP SOAP 
D. HTTPPUT 
(4) 下 面 选项 不 属于 使 用 Windows 验证 的 优点 的 一 项 是 
A. 容易 实现 。Windows 验证 基于 Windows 系统 的 安全 机 制 ， 使 用 起 来 不 需要 太 多 
额外 的 技术 。 
B. 能 完美 地 被 Web 服务 器 支持 。Windows 验证 可 以 与 任何 系统 平台 中 的 账户 进行 
集成 使 用 。 
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C. 无 过 高 要 求 。 配 置 起 来 非常 简单 ， 只 需要 在 Windows 视窗 界面 中 单 击 几 下 饼 标 即 
可 完成 配置 。 
D， 密 码 从 不 通过 网 络 发 送 。Windows 验证 会 在 客户 端 将 用 户 密码 使 用 散 列 算法 进行 
加 密 ， 因 此 保证 了 密码 的 安全 性 。 
三 、 上 机 练习 


上 机 练习 1: 在 Web 服务 项 目 中 配置 使 用 Windows 验证 。 

本 次 练习 要 求 以 例 10-3 中 的 查询 用 户 信息 的 Web 服务 WSUsers 为 例 ， 将 其 发 布 成 一 个 
Web 项 目 ， 并 上 传 到 Web 服务 器 中 。 然 后 在 Web 服务 器 中 将 其 访问 权限 验证 方式 修改 为 “ 集 
成 Windows 身份 验证 ”。 

设置 以 后 使 用 浏览 器 请 求 该 Web 服务 ， 运 行 结果 如 图 10-17 和 图 10-18 所 示 。 


TN Windows Internet Esplorer 
[ED http://19e. 168 0120/9Users em 


育 收 雪 交合 开间 


连接 到 192. 168.0.12 


正在 连接 到 | 192. 168. 0 12。 
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WSUsers 


The folowing cperations are supported. For a formal cefnitor, please review the Service Description. 


«FineUsergyName 


This web service is using http://tempuri.org/ as its default namespace. 

Recommendation: Change the default namespace before the XML Web service is made public. 

Each XML Web service needs a unique namespace in order for cient applications to distinguish it from other 

Semices on he Web. Pps/tempur erg/ I avallable Por XML Wet sevices that are Under development but 

Publshed Xp Web services should use a more permanent namespace, 

Your XML Web service shouid be identfied by 3 namespace that yo cortrel. For evample you can use your 

companys Internet domain name as par of the namespace. Athouoh many XML Web service namespaces” 国 
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图 10-18 ”验证 通过 


内 容 摘 要 : 


XML(Extensible Markup Language, 可 扩展 性 标记 语言 ) 是 一 种 描述 数据 和 数据 结构 的 语言 
是 基于 Web 数据 交互 的 语言 。XML 极其 简单 且 易 于 掌握 和 使 用 ， 又 因为 其 跨 平台 的 特性 ， 而 


) 


被 广泛 应 用 。 


本 章 将 学 习 如 何在 ASP.NET 中 读 取 和 写 入 XML， 以 及 如 何 对 XML 中 的 属性 和 节点 进行 
增删 改 的 操作 。 同 时 ， 还 学 习 了 如 何 对 XML 进行 序列 化 。 


学 习 目标 : 


掌握 4 种 读 取 XML 的 方式 

掌握 两 种 写 入 XML 的 方式 

会 使 用 DOM 技术 对 XML 文件 进行 增删 改 操作 
了 解 自 定 义 XML 序列 化 


11.1 从 XML 文件 中 读 取 新 闻 


在 ASPNET 中 读 取 XML 文档 信息 主要 有 如 下 4 种 方式 ， 本 节 将 对 它们 进行 详细 介绍 。 
@ ”使 用 XML 控件 读 取 。 

@ ”使 用 DOM 技术 读 取 。 

@ ”使 用 DataSet 对 象 读 取 。 

@ 使 用 XmlTextReader 类 读 取 。 


< 视频 教学 : 光盘 /videos/11/ 从 XML 文件 中 读 取 新 闻 .avi 人 长 度 : 13 分 钟 


11.1.1 基础 知识 一 一 读 取 XML 


现在 ， 我 们 新 建 一 个 ASPNET 项 目 ， 在 项 目 中 添加 一 个 XML 文件 。 然 后 ， 用 4 种 方式 读 
取 XML 文档 的 信息 ，XML 文档 的 代码 如 下 : 


<?xml Version="1.0"” encoding="utf-8" ?> 
<teachers> 
<teacher> 
<name> 张 华 </name> 
<age>32</age> 
<teach> 化 学 </teach> 
<address> 河 南 省 郑州 市 </address> 
</teacher> 
<teacher> 
<name> 李 江 </name> 
<age>45</age> 
<teach> 物 理 </teach> 
<address> 河 南 省 信阳 市 </address> 
</teacher> 
<teacher> 
<name> 王 丽 丽 </name> 
<age> 语 文 </age> 
<teach>26</teach> 
<address> 山 东 省 济南 市 </address> 
</teacher> 
<teacher> 
<name> 齐 菲菲 </name> 
<age>28</age> 
<teach> 数 学 </teach> 
<address> 湖 南 省 长 沙市 </address> 
</teacher> 
</teachers> 


m= > 


第 11 章 .NET 下 的 XML 操作 


1. 使 用 XML 控件 读 取 


使 用 XML 控件 读 取 是 比较 简单 的 一 种 方式 ，XML 控件 有 一 个 名 为 DocumentSource 的 属 
我 们 只 需要 将 所 要 读 取 的 XML 文档 的 路 径 赋 给 该 属性 即 可 。 
在 项 目 中 添加 一 个 名 为 UseXML.aspx 的 页 面 ， 向 页 面 中 添加 如 下 代码 : 


<html xmlns="http://www.w3.0org/1999/xhtml"> 
<head runat="server"> 
<title> 使 用 XML 控件 读 取 </title> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:Xml ID="Xmll" runat="server" 
DocumentSource="~/Teacher .xml"></asp:Xml> 
</div> 
</form> 
</body> 
</html> 


可 以 直接 从 【工具 箱 】 中 将 XML 控件 拖 至 UseXML.aspx 页 面 。 运行 该 页 面 ， 在 浏览 器 中 
查看 运行 结果 ， 如 图 11-1 所 示 。 


这 


使 用 za. 控件 起 取 -Windows Internet Explorer 


-加 loolost 
次 必 硬 天。 | 荐 使 用 ml 莹 忻 法 了 


图 11-1 使 用 XML 控件 读 取 


该 方法 只 需要 将 XML 文件 的 路 径 赋 给 XML 控件 的 DocumentSource 属性 就 可 以 了 , 方法 
很 简单 ， 可 是 数据 输出 的 格式 却 不 尽 如 人 意 。 

2. 使 用 DOM 技术 读 取 

.NET Framework 的 XML 类 为 我 们 提供 了 一 个 符合 W3C DOM 标准 的 XML 分 析 器 对 象 
XmlDocument, 它 是 在 .NET 环境 中 执行 大 多 数 基于 XML 操作 的 核心 对 象 。 通过 下 面 的 例子 了 
解 怎 样 使 用 XmlDocument 对 象 读 取 XML 文档 。 

新 建 一 个 名 为 UseDOM.aspx 的 页 面 , 然后 添加 一 个 XML 控件 , 我 们 不 需要 设置 控件 的 任 
何 属 性 。 代 码 如 下 所 示 : 


<%@ Page Language="C#" AutoEventWireup="true" CodeFile="UseDOM.aspx.cs" 
Inherits="UseDOM" 和 > 


< 于 一 
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<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.o0rg/1999/xhtml"> 
<head runat="server"> 

<title> 使 用 DoM 技术 读 取 </title> 
</head> 
<body> 

<form id="forml" runat="server"> 

<div> 

<asp:Xml ID="Xmll" runat="server"></asp:Xml> 

</div> 

</form> 
</body> 
</html> 


然后 打开 UseDOM.aspx 页 面 的 cs 文件 UseDOM.aspx.cs， 向 文件 中 添加 如 下 代码 : 


using System; 
using System.Collections.Generic; 
using System.Linqg; 
using System.Web; 
using System.Web.UI; 
using System.Web.UI.WebControls; 
using System.xml; 
public partial class UseDOM : System.Web.UI.Page 
{ 
protected void Page Load(object sender, EventArgs e) 
{ 
XxmlDocument dom = new XmlDocument (); 
dom.Load (Server.MapPath ("teache.xml")); 
Xmll .Document = dom; 


} 
运行 UseDOM.aspx 页 面 ， 结 果 如 图 11-2 所 示 。 


图 11-2 使 用 DOM 技术 读 取 
从 图 11-2 中 可 以 看 到 ， 使 用 DOM 技术 读 取 与 使 用 XML 控件 读 取信 息 显示 的 结果 相同 。 


虽然 我 们 同样 使 用 了 XML 控件 , 但 是 DOM 技术 并 没有 使 用 DocumentSource 属性 ， 而 是 使 用 


Eee >> 


3. 使 用 DataSet 对 象 读 取 


DataSet 将 数据 和 架构 作为 XML 文档 格式 进行 读 写 。 如 表 11-1 所 示 , 列 出 了 DataSet 处 理 
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了 XmlDocument 对 象 的 Load 方法 载 入 要 读 取 的 XML 文档 ,然后 将 XML 控件 和 XmlDocument 


XML 的 常用 方法 。 
表 11-1 DataSet 处 理 XML 的 常用 方法 
方 法 说 明 
Getxml | 返回 存储 在 Dataset 中 的 数据 的 XML 表示 形式 
GetXmlSchema | 以 XML 形式 返回 存储 在 DataSet 中 的 XSD 架构 
ReadXml | 用 于 将 XML 架构 和 数据 读 入 Dataset 
ReadXmlSchema 用 于 将 XML 架构 读 入 DataSet 
WriteXml 用 于 将 DataSet 的 数据 写 入 XML 中 
WriteXmlSchema 用 于 写 XML 架构 形式 的 DataSet 结构 


下 面 通过 实例 详细 描述 如 何 使 用 DataSet 对 象 载 入 XML 文档 。 


首先 ， 在 项 目 中 添加 一 个 名 为 UseDataSet.aspx 的 页 面 ， 并 在 文件 中 添加 如 下 代码 : 


<%@ Page Language="C#" AutoEventWireup="true" CodeFile="UseDataSet.aspx.cs" 


Inherits="UseDataSet" %> 


<!1DOCTYPE htm] PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.o0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 


<html xmlns="http://www.w3.o0rg/1999/xhtml"> 
<head runat="server"> 
<title></title> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:GridView ID="GridViewl" runat="server"> 
</asp:GridView> 
</div> 
</form> 
</body> 
</html> 


然后 ， 打 开 UseDataSet.aspx 页 面 的 cs 文件 UseDataSet.aspx.cs， 并 添加 如 下 代码 : 


using System; 

using System.Collections.Generic; 

using System.Linqg; 

using System.Web; 

using System.Web.UI; 

using System.Web.UI.WebControls; 

using System.Data; 

public partial class UseDataSet : System.Web.UI.Page 


ML 操作 四 


E15 
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protected void Page Load(object sender, EventArgs e) 


{ 
DataSet ds = new DatasSet(); 
ds.ReadXml (Server .MapPath ("Teacher .xml1")); 
GridViewl .DataSource = ds.Tables["teacher"] .DefaultView; 
GridViewl .DataBind(); 
’ 


} 


运行 UseDataSet.aspx 页 面 ， 运 行 结果 如 图 11-3 所 示 。 


帘 收 本 天 | 世 http://Tocaliost;258L/resbmlyUselataset 


name age teach address 
张 华 32 化 学 河南 省 郑州 市 
李江 45 ”物理 河南 省 信阳 市 


王 丙 丽 语文 26 山东 省 济南 市 
齐 非 非 28 数学 湖南 省 长 沙市 


图 11-3 使 用 DataSet 对 象 载 入 XML 文档 


该 例 中 ， 先 使 用 DataSet 对 象 载 入 XML 中 的 数据 ， 然 后 使 用 GridView 控件 将 数据 显示 在 
页 面 上 。 数 据 以 表格 形式 展示 ， 显 然 比 之 前 两 种 更 清晰 。 


4. 使 用 XmlTextReader 类 读 取 


使 用 XmlTextReader 对 象 可 以 读 取 磁 盘 文 件 ， 并 且 以 XML 节点 列表 形式 显示 数据 。 下 面 
举例 说 明 如 何 使 用 XmlTextReader 对 象 读 取 XML 文件 。 因 为 是 以 文本 形式 读 取 ， 所 以 前 台 页 
面 UseText.aspx 很 简单 ， 我 们 只 需要 放 一 个 Label 控件 就 可 以 了 ，Label 控件 名 为 IbIXML。 下 
面 是 UseText.aspx 页 面 的 后 台 代 码 : 


protected void Page_Load (object sender, EventArgs e) 
{ 
XmlTextReader xtxtR = new 
XmlTextReader (Server.MapPath ("Teacher .xml") ) 7 
string strResult = ""; 
XmlNodeType xnt; 
while (xtxtR.Read()) 
{ 
xnt = xtxtR.NodeType; 
switch (xnt) 
{ 
case XmlNodeType.XmlDeclaration: 
// 读 取 文件 头 
strResult += "<font color='#0033FF'> 文 件 头 :</font>" + 
xtxtR.Name + "" + xtxtR.Value + "</br>"; 
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break; 
case XmlNodeType.Element: 
// 读 取 标 签 
strResult += "<font color='#0099FF'> 读 取 标 签 :</font>" + 
xtxtR.Name + "" + xtxtR.Value + "</br>"; 
break; 
case XmlNodeType.Text: 


// 读 取 值 


strResult += "&nbsp;-<font color='#00CCFF'> 值 :</font>" + 
xtxtR.Name + "" + xtxtR.Value + "</br>"; 


break; 
if (xtxtR.AttributeCount > 0) 


while (xtxtR.MoveToNextAttribute()) 


{ 
strResult += "&nbsp;<font color='#ff3dee'>- 属 性 </font>" + 


xtxtR.Name + "<font color='#ff3dee'>- 值 </font>"+xtxtR. 


Value+"</br>"; 


} 
lblXML.Text = strResult; 


} 
在 本 例 中 ， 我 们 使 用 XmlTextReader 对 象 创建 实例 ， 读 取 XML 文件 ， 显 示 的 结果 以 节点 
列表 形式 输出 ， 如 图 11-4 所 示 。 


图 11-4 使 用 XmlTextReader 读 取 XML 文件 


11.1.2 ”实例 描述 


我 们 已 经 了 解 到 读 取 XML 的 4 种 方式 ， 根 据 4 种 方法 显示 的 结果 来 看 ， 使 用 DataSet 方 
式 读 取 显 示 的 结果 是 以 表格 形式 显示 ， 条 理 分 明 、 结 构 清晰 。 


< 


下 面 通过 一 个 保存 新 闻 信息 的 XML 文档 ， 看 看 如 何 使 用 DataList 控件 进行 读 取 并 显示 。 


11.1.3 ”实例 应 用 


【 例 11-1】 从 XML 文件 中 读 取 新 闻 
(1) 打开 11.1.2 节 建 立 的 ASPNET 项 目 ， 然 后 新 建 一 个 XML 文件 ， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8" ?> 
<news> 
<new> 
<ID>001</ID> 
<title> 花 样 衬衫 巧 拱 修 身 裤 魅力 无 法 挡 </title> 
<image>1.jpg</image> 
<content> 衬 衫 一 向 以 一 种 独特 的 中 性 美 取胜 , 而 本 季 的 衬衫 却 大 相 径 庭 一 一 它 更 为 妩媚 与 柔 
美 ， 独特 的 设计 为 都 市 女性 树立 了 独立 间 不 失 性 感 与 优雅 的 气质 。 巧 搭配 裤 装 ， 享 受 这 个 多 姿 
多 彩 的 早春 气息 吧 。 时尚 解 析 : 阔 腿 裤 了 永远 走 在 时 尚 前 沿 , 拥有 了 大 量 追 兵 者 。 </content> 
</new> 
<new> 
<ID>002</ID> 
<title> 健 康 指南 : 红 暮 千 万 别 跟 什么 同 吃 </title> 
<image>2.jpg</image> 
<content> 喜 欢 吃 杂 粮 的 刘 大 和 爷 告诉 记者 ， 前 几 天 一 次 晚饭 时 吃 了 几 个 红薯 ， 相 隔 不 到 半 小 时 
又 吃 了 一 个 柿子 , 晚上 看 电视 的 时 候 肚 子 开始 疼 了 。 红薯 鼠 与 柿子 同 吃 红 莫 和 柿子 不 宜 在 短 
时 间 内 同时 食用 ， 如 果 食 量 多 的 情况 下 ， 应 该 至 少 相隔 五 个 小 时 以 上 。</content> 
</new> 
<new> 
<ID>003</ID> 
<title> 老 人 早春 饮食 ， 一 二 三 四 口诀 </title> 
<image>3.jpg</image> 
<content> 不 宜 硬 : 在 早晨 ， 老 年 人 不 宜 进食 油腻 、 煎 炸 、 干 硬 以 及 刺激 性 大 的 食物 ， 否 则 会 
劳 牧 伤 角 ， 导 致 食 灌 于 中 ， 消 化 不 良 。 老 年 人 早餐 宜 吃 容易 消化 的 温 热 、 柔 软 食物 ， 如 加 些 莲 
子 、 红 束 、 山 药 、 桂 圆 和 巧 仁 等 保健 食品 ， 则 效果 更 佳 。</content> 
</new> 
<new> 
<ID>004</ID> 
<title>iPhone 再 现 全 民 漂 移 跑 跑 卡丁车 口袋 版 </title> 
<image>4.jpg</image> 
<content> 泡 泡 网 手机 频道 3 月 15 日 红 遍 全 国 的 网 络 游戏 “ 跑 跑 卡丁车 ”如 今 被 完美 移植 
到 了 iPhone， 短 短 1 天 时 间 便 以 免费 的 实惠 与 精美 的 制作 跻身 排行 榜 榜首 。</content> 
</new> 
</news> 


(2) 新 建 一 个 名 为 ShowNews.aspx 的 页 面 ， 在 页 面 内 添加 一 个 DataList 控件 ， 页 面 代码 
如 下 : 


<$%Q@ Page Language="C#" AutoEventWireup="true" CodeFile="ShowNews.aspx.cs" 
Inherits="ShowNews" $%> 


mi > 
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<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.o0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<htm] xmlns="http://www.w3.o0rg/1999/xhtml"> 
<head runat="server"> 
<title> 实 例 -显示 新 闻 列表 </title> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div style="font-family: 宋体 GB2312; font Sizes 12px7”> 
<asp:DataList ID="DataListl" runat="server"> 
<ItemTemplate> 
<table border="0" width="760" id="tablel" cellspacing="0" 
cellpadding="0" bgcolor="#ffffff"> 
<tr> 
<td width="150" align="center"> 
<img border=" mage/<%#Eval ("image") %>' 
width="110" height="120" align="center"> 
</td> 
<td style="line-height: 1" valign="top"> 
<br> 
<%#Eval ("ID") %><br> 
标题 : <%#Eval ("title") %><br> 
内 容 : <%#Eval ("content") %><br> 
</td> 
</tr> 
</table> 
</ItemTemplate> 
</asp:DataList> 
</div> 
</form> 
</body> 
</html> 


(3) ShowNews.aspx 页 面 的 后 台 代码 如 下 : 


protected void Page_Load (object sender, EventArgs e) 


{ 


” SIC 


DataSet ds = new DataSet (); 
ds .ReadXml (Server.MapPath ("News .xml") ) 7 
DataList1l.DataSource = ds.Tables[0] .DefaultView; 
DataListl.DataBind(); 

} 


(4) 保存 ， 这 样 实例 就 完成 了 。 
11.1.4 ”运行 结果 


运行 ShowNews.aspx， 显 示 结 果 如 图 11-5 所 示 。 
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图 11-5 运行 结果 


11.1.5 ”实例 分 析 


pm 


在 实例 中 ， 我 们 使 用 DataList 数据 控件 从 XML 中 读 取 数据 和 显示 。 其实 ，ASP.NET 中 的 
任意 一 个 数据 控件 都 可 以 完成 ， 但 是 要 注意 需要 在 前 台 页 面 使 用 Eval 进行 数据 绑 定 ， 否 则 数 


11.2” 写 入 XML 的 收 件 箱 


我 们 已 经 掌握 了 怎样 在 .NET 中 读 取 XML， 本 节 将 学 习 如 何 向 XML 中 写 入 内 容 。 这 些 内 
容 可 以 是 在 创建 时 指定 的 ， 也 可 以 手动 一 次 写 入 一 个 指定 的 XML 元 素 。 选 择 哪 种 方式 完全 取 
决 于 读者 的 喜好 。 


rc 视频 教学 : 光盘 /videos/11/ 写 入 XML 的 收 件 箱 .avi 人 长度: 15 分 钟 
11.2.1 ”基础 知识 一 一 写 入 XML 


在 ASPNET 中 写 入 XML 文件 有 很 多 种 方法 ， 在 这 里 只 介绍 两 种 比较 常用 的 方法 : 使 用 
DataSet 写 入 和 使 用 文本 方式 写 入 。 

使 用 DataSet 和 文本 方式 写 入 XML 不 同 的 是 : 使 用 DataSet 方式 写 入 XML 文档 所 需 的 数 
据 是 从 数据 库 表 中 直接 读 取 的 ， 而 使 用 文本 方式 写 入 XML 则 是 手动 写 入 。 下 面 我 们 就 来 详细 


m= >> 
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了 解 两 种 写 入 XML 的 方法 。 

1. 使 用 DataSet 写 入 

有 时 候 我 们 需要 对 数据 表 里 的 数据 进行 操作 ,为 了 让 数据 表 的 操作 性 更 加 灵活 方便 ， 可 以 
使 用 DataSet 对 象 将 数据 表 里 的 数据 转换 为 XML 文件 。 

要 想 写 入 XML 文件 ， 只 需要 使 用 DataSet 对 象 的 WriteXml 方法 。 在 System.Data 命名 空 
间 下 的 DataSet 对 象 可 以 很 容易 地 将 一 个 数据 库 文件 存储 为 XML 文件 。 具 体 步骤 如 下 。 

(1) 先 准 备 好 要 写 入 XML 文件 的 数据 库 表 ， 在 这 里 使 用 myDataBase 数据 库 的 Users 表 ， 
我 们 使 用 的 数据 库 是 SQL Server 2008，Users 表 的 表 结 构 和 数据 如 图 11-6 所 示 。 
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图 11-6 Users 表 的 表 结构 和 数据 


(2) 新 建 一 个 ASPNET 项 目 ， 项 目 名 称 为 writerxml， 添 加 UserDataSet.aspx 页 面 ， 然 后 
在 UserDataSet.aspx 页 面 的 后 台 文件 UserDataSet.aspx.cs 里 添加 如 下 代码 : 


using 
using 
using 
using 
using 
using 
using 
using 
using 


System; 
System. 
System. 
System. 
System. 
System. 
System 
System. 
System. 


Collections.Generic; 
Linqg; 

Web; 

Web .UI; 
Web.UI.WebControls; 


.Data.SqlClient; 


Configuration; 
Data; 


public partial class _UserDataSet: System.Web.UI.Page 


{ 


protected void Page Load(object sender, EventArgs e) 


,| 


string 
ID=sa 


constring = "Data Source=.;Initial Catalog=myDataBase;User 


?Password=123"; 


SqlConnection con = new SqlConnection(constring); 


string 
志和 下 和 
{ 


strSql = "select * from Users™; 


con.Oopen(); 
SqlDataAdapter sda = new SqlDataAdapter(strsql, con); 


< 人 一 


©.,. 服务 开发 学 习 实录 


DataSet ds = new DataSet (); 
sda.Fill(ds); 
ds.Writexml (Server.MapPath ("Users -Xml") ) 7 


Response.Write ("Users .xml 文件 创建 成 功 ! ") 7 


} 
catch (SqlException ex) 
{ 
Response.Write (ex.Message); 
> 
finally 
{ 
con.Cclose(); 
} 
} 
} 
(3) 运行 该 页 面 ， 浏 览 器 显示 结果 ， 如 图 11-7 所 示 。 这 表示 XML 文件 创建 成 功 。 


使 用 DataSet 创 建 YU 文件 - Windovs Internet Explorer 大 | 顾 | 区 | 


e localhost 


宣 收藏 天 。 乱 便 用 Datwset 白 寻 xmlL 文 件 


Users xm[ 文 件 创建 成 功 1 


图 11-7 XML 文件 创建 成 功 
(4) 在 【解决 方案 资源 管理 器 】 中 刷新 网 站 目录 ， 创 建 好 的 XML 文件 就 会 出 现在 当前 目 
录 中 。 在 浏览 器 中 打开 创建 好 的 Users.xml 文件 ， 可 以 看 到 写 入 的 内 容 ， 如 图 11-8 所 示 。 


ET Dr riterml srs ml 
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peml varsion="1 0" standalone="yas" 7 
- <NewDataSet> 
~ <rabla> 
<ID>1<fiD> 
<Name>Lily</Name> 
<age>23</Age> 
<Hobby> 看 书 ,十 字 尹 </Hobby> 
S/Table> 
- <Table> 
<ID>2</ID> 
<Name> 手 阴 </Name> 
<Ago>15</Age> 
<Hobby> 打 网 球 <jHobby> 
</Table> 
- <Table> 
<ID>3clip> 
<Name> 醒 本 </Name> 
<Age>16</Age> 
<Hobby> 咎 球 <IHobby> 
<fTable> 
- <Table> 
<ID>4</ID> 


<Name> 酝 于 <Name> 
<Age>24</Age> 
<Hobby> 变 魔术 ， 种 车 果 </Hobby> 


</Table> 
/NewDataSet> 


11-8 XML 文件 内 容 
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2. 使 用 文本 方式 写 入 


在 11.1 节 我 们 使 用 XmlTextReader 类 从 磁盘 上 读 取 文 件 。 与 它 对 应 的 XmlTextWriter 类 可 
以 完成 XML 文件 的 写 入 操作 。 下 面 是 使 用 XmlTextWriter 类 的 具体 步骤 。 

(1) 打开 11.1 节 创建 好 的 项 目 ， 添 加 一 个 名 为 UserText.aspx 的 页 面 ， 打 开 UserText.aspx 
页 面 的 UserText.aspx.cs 文件 ， 添 加 如 下 代码 : 


using 
using 
using 
using 
using 
using 
using 


System; 
System.Collections.Generic; 
System.Linqg; 

System.Web; 

System.Web.UI; 
System.Web.UI.WebControls; 
System.Xml; 


public partial class UserText : System.Web.UI.Page 


{ 


protected void Page Load(object sender, EventArgs e) 


{ 


XmlTextWriter xmlTw = null; 

xmlTw = new XmlTextWriter (Server.MapPath ("books.xml"), null); 
xmlTw.Formatting = Formatting.Indented; 

xmlTw.Indentation = 3; 

xmlTw.WritestartDocument (); 

xmlTwWw .WriteComment ("已 经 使 用 XMLTextWriter 创建 完毕 一 " + DateTime.Now); 
xmlTw.WritestartElement ("books"); 

xmlTw.WritestartElement ("book"); 

xmlTw.WriteAttributestring ("Category", "古典 名 著 ") ; 
xmlTw.WriteElementstring ("Title", "红楼 梦 ") ; 


DateTime edition = new DateTime (2010，03，05);// 出 版 版 本 
xmlTw.WriteElementSstring ("edition", edition.ToString ("yyyy-MM-dd")); 
int intSales = 32; 

xmlTw.WriteElementSstring ("price",intSales.ToString("G")); 
xmlTw.WriteStartElement ("AuthorList"); 
xmlTw.WriteElementstring ("Author", "曹雪芹 ") ; 
xmlTw.WriteElementstring ("Author",， "高 鸭 ") ; 
xmlTw.WriteEndElement (); 

xmlTw.WriteEndElement (); 

xmlTw.Flush(); 

xmlTw.Close(); 

Response.Write ("已 经 创建 XML 文件 books .xml") ; 


如 上 述 代码 所 示 ， 这 里 主要 是 使 用 XmlTextWriter 类 来 完成 XML 的 写 入 ， 其 中 用 到 了 
XmlTextWriter 类 的 大 量 方法 。 在 表 11-2 中 给 出 了 这 些 方法 的 说 明 。 


R73 


m2 > 


表 11-2 XmlTextWriter 类 的 方法 


方 法 说 明 
WriteStartDocument 描述 版 本 为 “1.0” 的 XML 声明 
WriteEndDocument 关闭 任何 打开 的 元 素 或 属性 
Close 关闭 流 
WriteDocType 写 出 具有 指定 名 称 和 可 选 属性 的 DOCTYPE 声明 
WriteStartElement 写 出 指定 的 开始 标记 
WriteEndElement 关闭 一 个 元 素 
WriteFullEndElement 关闭 一 个 元 素 ， 并 且 总 是 写 入 完整 的 结束 标记 
WriteElementString 写 出 包含 字符 串 值 的 元 素 
WriteStartAttribute 书写 属性 的 起 始 内 容 
WriteEndAttribute 关闭 上 一 个 WriteStartAttribute 调用 
WriteRaw 手动 书写 原始 标记 
WriteString 书写 一 个 字符 串 
WriteAttributeString 出 具有 指定 值 的 属性 
WriteCData 写 出 包含 指定 文本 的 <![CDATA[.. 了 > 块 
WriteComment 写 出 包含 指定 文本 的 注释 _<!--…--> 


WriteWhiteSpace 


WriteProcessingInstruction 


Flush 


写 出 给 定 的 空白 
写 出 在 名 称 和 文本 之 间 带 有 空格 的 处 理 指令 ， 如 下 所 示 : <?name text?> 
将 缓冲 区 中 的 所 有 内 容 刷 新 到 基础 流 ， 并 同时 刷新 基础 流 


(2) 运行 该 页 面 ， 结 果 如 图 11-9 所 示 ， 表 示 使 用 文本 创建 的 XML 文件 已 经 创建 成 功 。 


(3) 在 【解决 方案 资源 管理 器 】 中 刷新 网 站 目录 ， 创 建 好 的 books.xml 文件 已 出 现在 当前 


GO: 


丛 必 本 天 。 基 要 文 不 地 eu 


已 经 创建 XML 文件 books xml 


图 11-9 使 用 文本 创建 XML 文件 


目录 。 在 浏览 器 中 打开 该 文件 ， 显 示 结 果 如 图 11-10 所 示 。 


11-10 ”使 用 文本 创建 的 XML 文件 
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11.2.2 ”实例 描述 


本 节 将 通过 一 个 实例 帮助 读者 更 好 地 掌握 如 何 写 入 XML 此 实例 使 用 XmlTextWriter 类 创 
建 一 个 XML 文件， 再 使 用 DataSet 进行 读 取 ， 然 后 将 创建 好 XML 文件 内 容 显示 在 页 面 上 。 


11.2.3 ”实例 应 用 


【 例 11-2】 写 入 XML 的 收 件 箱 
(1) 打开 11.2.1 节 创 建 的 项 目 writerxml, 新 建 一 个 名 为 message.aspx 的 页 面 , 并 添加 一 个 
GridView 控件 ， 用 于 显示 数据 。 前 台 代码 如 下 : 


<div> 
<br /> 
我 的 收 件 箱 <br /> 
<asp:GridView ID="GridViewl" runat="server" BackColor="White" 
BorderColor="#CCCCCC" BorderSstyle="None" BorderWidth="1lpx" 
CellPadding="3" 
EnableModelValidation="True"> 
<Footerstyle BackColor="White" ForeColor="#000066" /> 
<Headerstyle BackColor="#006699" Font-Bold="True" ForeColor="White" /> 
<Pagerstyle BackColor="White" ForeColor="#000066" 
HorizontalAlign="Left" /> 
<RowStyle ForeColor="#000066" /> 
<SelectedRowStyle BackColor="#669999" Font-Bold="True" 
ForeColor="White" /> 
</asp:GridView> 
</div> 


(2) 打开 message.aspx 页 面 的 cs 文件 message.aspx.cs 文件 ， 添 加 如 下 代码 : 


using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Web; 

using System.Web.UI; 

using System.Web.UI.WebControls; 

using System.xml; 

using System.Data; 

public partial class Message : System.Web.UI.Page 
{ 


protected void Page_Load (object sender, EventArgs e) 
| 
if (GetXML () ) 
{ 
DataSet ds = new DataSet (); 
ds .ReadXml (Server.MapPath ("message.xml")); 


< 全 mm 
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GridViewl.DataSource = ds.Tables["message"] .DefaultView; 
GridViewl.DataBind(); 


} 
private bool GetXML () 
1 
XmlTextReader xr = new XmlTextReader (Server.MapPath ("message.xml")); 
if (xr != null) 
{ 
xmlTextWriter xmlTw = null; 
xmlTw = new XmlTextWriter (Server.MapPath ("message.xml"), null); 
xmlTw.Formatting = Formatting.Indented; 
xmlTw.Indentation = 3; 
xmlTw.WritestartDocument (); 
xmlTw.WriteComment ("已 经 使 用 XMLTextWriter 创 建 完毕 一 " + DateTime .Now) ; 
xmlTw.WritestartElement ("messages"); 
xmlTw.WritestartElement ("message"); 
xmlTw.WFiteRAttributeString("Type"，" 陌 生 消息 ") ; 
xmlTw.WriteElementstring ("ID", "0010025"); 
xmlTw.WriteElementstring ("Title",， "加 我 "); 
xmlTw.WriteElementString ("Content"，" 我 是 嘻 哮 鼠 ， 加 我 好 友 吧 ") ; 
DateTime edition = new DateTime (2010, 05, 05); 
xmlTw.WriteElementstring("datetime", edition.ToString ("yyyy-MM-dd")); 
xmlTw.WriteElementSstring ("FromName"， "了 嘻 嘻 鼠 "); 
xmlTw.WriteElementstring ("ToName", "高 山 "); 
xmlTw.WriteEndElement (); 
xmlTw.WritestartElement ("message"); 
xmlTw.WriteAttributeSstring ("Type"， "系统 消息 ") ; 
xmlTw.WriteElementstring ("ID", "0010026"); 
xmlTw.WriteElementString ("Title"，" 系 统 消息 "); 
xmlTw.WriteElementSstring ("Content",， "您 的 收 件 箱 已 满 ， 请 查阅 并 整理 ") ; 
DateTime editionl = new DateTime (2010, 12, 13); 
xmlTw.WriteElementSstring ("datetime", edition]l.ToSstring("yyyy-MM-dd")); 
xmlTw.WriteElementString ("FromName"，" 服 务 器 "); 
xmlTw.WriteElementstring ("ToName", "高 山 "); 
xmlTw.WriteEndElement (); 
xmlTw.WriteEndElement (); 
xmlTw.Flush(); 
xmlTw.Close(); 
return true; 
让 
在 下 有 全 
本 


return false; 
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GetXML 方法 用 于 创建 XML 文件 message.xml， 在 创建 之 前 ， 先 使 用 XmlTextReader 判 
断 是 否 存在 该 XML 文件 ,如 果 不 存在 ,再 进行 创建 ,在 页 面 的 Load 事件 里 ,调用 方法 GetXML， 
并 且 使 用 GridView 控件 进行 显示 。 


@ $ 我 们 在 创建 XML 文件 时 ,如果 想 要 添加 多 条 数据 , 需要 在 完成 一 条 数据 创建 后 使 
注意 | 用 WriteEndElement() 关 闭 这 个 元 素 。 


11.2.4 ”运行 结果 


运行 message.aspx 页 面 ， 显 示 结 果 如 图 11-11 所 示 。 


图 11-11 页 面 显 示 的 结果 
打开 创建 好 的 XML 文件 ， 结 果 如 图 11-12 所 示 。 


ssage 
- <message Type= 俩 生 消息 "> 
>0010025</iD> 
<Title> 加 我 </Title: 
<Content > 生 是 时 如 我 好 友 吧 </Content> 
-| 


</message> 
-<message Type-' 系 统 消 息 "> 
;00t0026 p> 
<Thle> 和 撤消 息 </ 
er 地 的 人 条 请 ， 请 相关 天理 -人 content 
<datatime>2010-12-13</datetime> 
<FromName> 服 务 咕 </FromNzme> 
<ToeName> 商 山 <jToName> 


</messages> 


11-12 XML 文 件 


11.2.5 ”实例 分 析 


让 www 


使 用 文本 创建 XML 文件 时 ， 添 加 的 数据 比较 多 时 ， 要 记得 关闭 元 素 。 我 们 可 以 使 用 
XmlTextReader 类 读 取 XML 文件 ， 根 据 其 返回 的 结果 是 否 为 空 判 断 该 XML 文件 是 否 存在 。 


< 


11.3 “宠物 信息 的 增删 改 操作 


上 面 的 两 个 章节 我 们 主要 讲 了 如 何 读 取 和 写 入 XML 文件 ， 本 章节 中 我 们 将 讲解 如 何 对 


XML 文件 进行 增删 改 的 操作 。 
接 下 来 ， 我 们 以 “宠物 信息 ”为 例 ， 讲 解 如 何 对 XML 文件 进行 增加 、 删 除 、 修 改 的 操作 。 
co 视频 教学 : 光盘 /videos/11/ 完 物 信 息 的 增删 改 操作 .avi 长 度 : 10 分 钟 


11.3.1 ”实例 描述 


如 果 说 读 取 和 写 入 XML 文件 时 ， 针 对 的 是 XML 文档 的 整体 的 处 理 。 那 么 本 节 所 讲 的 则 
是 针对 XML 文档 中 属性 或 节点 的 增加 、 删 除 和 修改 操作 ， 并 将 最 终结 果 显示 在 页 面 上 。 

有 时 ， 我 们 将 XML 文件 读 取 并 显示 到 了 页 面 上 时 ， 会 发 现 需要 添加 一 条 数据 或 者 修改 某 
条 数据 ， 那 么 在 不 直接 对 XML 文件 进行 操作 的 前 提 下 ， 要 如 何 进行 操作 呢 ， 下 面 就 让 我 们 来 
看 看 吧 。 


11.3.2 ”实例 应 用 


【 例 11-3】 宠物 信息 的 增删 改 操作 
(1) 新 建 一 个 ASP.NET 项 目 ， 添 加 XML 文件 petxml， 下 面 是 XML 文件 内 容 : 


<?xml Version="1.0"” encoding="utf-8"?> 
<petlist> 
<pet master="Allen"> 
<petname> 小 乖 </petname> 
<age>3</age> 
<pettype> 拉 布 拉 多 犬 </pettype> 
<birth> 加 拿 大 </birth> 
</pet> 
<pet master="Lily"> 
<petname> 咪 咪 </petname> 
<age>2</age> 
<pettype> 波 斯 猫 </pettype> 
<birth> 土 耳 其 </birth> 
</pet> 
</petlist> 


(2) 添加 Defaultaspx 页 面 , 因为 无 须 对 前 台 页 面 进 行 布局 ,， 所 以 在 Default.aspx 后 台 页 面 
Default.aspx.cs 中 添加 如 下 代码 ， 将 XML 文件 内 容 显示 在 页 面 上 : 


using System; 
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using System.Collections.Generic; 
using System.Linq; 
using System.Web; 
using System.Web.UI; 
using System.Web.UI.WebControls; 
using System.xXml; 
using System.Data; 
public partial class Default : System.Web.UI.Page 
# 
protected void Page Load(object sender, EventArgs e) 
{ 
ShowxmlValue (); 
} 
/// <summary> 
/// 显示 XML 信息 
/// </summary> 
private void ShowxmlValue() 
{ 
// 显 示 
string XMLFile = Server.MapPath ("pet .xm1l") 7 
Xml1Document xmlDoc = new XmlDocument () 7 
xmlDoc.Load (XMLFile); 
XmlNode xn = xmlDoc.SelectSingleNode ("petlist"); 
XmlNodeList xnl = xn.ChildNodes; 
foreach (XmlNode xnf in xnl) 
{ 
xmlElement Pet = (XmlElement)xnf; 
Response.Write ("主人 名 称 : "+ pet.GetAttribute ("master") + "<br>"); 
// 显 示 属 性 值 
XmlNodeList xnfl = pet.ChildNodes; 
foreach (XmlNode xn2 in xnfl) 
{ 


// 显 示 子 节点 文本 
Response .Write(" 宠 物 信息 : "+ xn2.InnerText + "<br>"); 
} 


Response.Write("<hr/>"); 


} 


在 该 例 中 我 们 使 用 DOM 技术 读 取 XML 文件 , 这 样 能 更 好 地 控制 单个 节点 和 属性 的 显示 。 
首先 ,使 用 XmlNode 获得 XML 文档 的 第 一 个 节点 , 然后 使 用 XmlNodeList 集合 该 节点 下 的 所 
有 子 节点 ， 最 后 使 用 foreach 循环 显示 。XmlElement 表示 一 个 元 素 ，GetAttribute 是 指 该 元 素 的 
属性 ，ChildNodes 指 该 元 素 下 的 所 有 子 节点 。 

(3) 添加 方法 AddXMLValue， 该 方法 表示 在 <petlist> 节 点 中 插入 master 属性 值 为 “小 可 ” 
的 <pe 己 节点， 代码 如 下 : 


/// <summary> 


< 全 mm 
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/// 增加 节点 
/// </summary> 
private void AddXMLValue () 


{ 


} 


string XMLFile = Server.MapPath ("pet.xml"); 

XmlDocument xmlDoc = new XmlDocument () 7 

xmlDoc.Load (XMLFile); 

XmlNode root = xmlDoc.SelectsingleNode ("petlist"); // 查 找 <petlist> 


xmlElement pet = xmlDoc.CreateElement ("pet"); // 创 建 一 个 <pet> 节 点 
XmlElement petname = xmlDoc.CreateElement ("petname"); 
petname.InnerText =“" 遇 遇 "; // 设 置 文 本 节点 
pet.AppendCchild (petname); // 添 加 到 <pet> 节 点 中 


pet.SetAttribute ("master", "小 可 "); 

XmlElement age = xmlDoc.CreateElement ("age"); 
age.InnerText = "1"; 

pet.AppendChild(age); 

XmlElement pettype = xmlDoc.CreateElement ("pettype"); 
pettype.InnerText = "黄金 鼠 仓 鼠 "; 

pet.AppendChild (pettype); 

XxmlElement birth = xmlDoc.CreateElement ("birth"); 
birth.InnerText = "叙利亚 "; 

Pet .APPendCchild (birth); 

root .Appendchild (pet) ;// 添 加 到 <petl1ist> 节 点 中 
xmlDoc.Save (XMLFile); 


从 代码 中 我 们 可 以 看 到 ， 添 加 操作 和 写 入 XML 文档 十 分 相似 ， 不 同 的 是 ， 添 加 操作 不 用 
重新 创建 XML 文档 。 

(4) 添加 方法 UpdXMLValue, 它 表 示 对 新 添加 的 节点 进行 修改 , 将 master 属性 值 改 为 “ 王 
小 可 ”， 将 子 节点 <petname> 的 文本 改 为 “小 波 ”， 代 码 如 下 : 

/// <summary> 

/// 修改 


/// </summary> 
private void UpdXMLValue () 


{ 


string XMLFile = Server.MapPath ("pet.xml"); 
XmlDocument xmlDoc = new XmlDocument (); 
xmlDoc.Load (XMLFile); 
XmlNodeList nodeList = xmlDoc.SelectSingleNode ("petlist") .ChildNodes; 
// 获 取 petlist 节点 的 所 有 子 节点 
foreach (XmlNode xn in nodeList) // 遍 历 所 有 子 节点 
{ 
XmlElement pet = (XmlElement)xn;// 将 子 节点 类 型 转换 为 xmlElement 类 型 
if (pet.GetAttribute ("master") == "小 可 ") 
攻 
pet .SetRAttribute ("master"v" 王 小 可 ") ; // 修 改 属 性 值 
XmlNodeList nls = pet.ChildNodes; // 继 续 获取 pet 子 节点 的 所 有 子 节点 
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foreach (XmlNode xnl in nls) // 遍 历 
1 
XmlElement petChild = (XmlElement)xnl; // 转 换 类 型 
if (petChild.Name == "petname") // 如 果 找 到 
上 
if (petchild.InnerText == "了 遇 员 ") // 修 改 


{ 
petChild.InnerText = "小 波 "; 
} 


break; // 修 改 后 跳出 循环 


} 
xmlDoc.Save (XMLFile); // 保 存 
} 


在 该 方法 中 ， 遍 历 子 节点 ， 先 将 所 有 子 节点 类 型 转换 为 XmlElement 类 型 ， 然 后 使 用 
GetAttribute 找到 指定 名 称 的 属性 值 ， 接 着 使 用 SetAttribute 修改 属性 值 。 修 改 子 节点 内 容 也 
一 样 。 

(5) 添加 方法 DelXMLValue， 它 表示 删除 “<pet master=" 念 玉 ">” 节 点 的 master 属性 ， 同 
时 删除 “<pet master=" 王 小 可 心 ”节点 。 代 码 如 下 。 


/// <summary> 

/// 删除 

/// </summary> 

private void DelxMLValue() 

{ 
string XMLFile = Server.MapPath ("pet.xml"); 
XmlDocument xmlDoc = new XmlDocument (); 
xmlDoc.Load (XMLFile); 
XmlNodeList xnl = xmlDoc.SelectSingleNode ("petlist") .ChildNodes; 
foreach (XmlNode xn in xnl) 
{ 

xmlElement Pet = (XmlElement)xn; 


if (pet.GetAttribute ("master") == "人 锚 玉 ") 
pet.RemoveAttribute ("master"); // 移 除 属性 
a if (pet.GetAttribute ("master") == " 王 小 可 ") 
pet.RemoveAll (); // 删 除 该 节点 
pet.ParentNode.RemoveChild (pet); // 删 除 其 本 身 


} 
xmlDoc.Save (XMLFile); 


< 人 针 一 


GE 


11.3.3 ”运行 结果 


我 们 分 别 在 Default.aspx 页 面 的 load 事件 里 引用 定义 的 三 个 方法 ， 然 后 查看 其 运行 效 
原始 代码 的 运行 效果 如 图 11-13 所 示 。 
添加 AddXMLValue 方法 后 运行 该 页 面 ， 运 行 结果 如 图 11-14 所 示 。 


11-13 ”未 改动 的 运行 结果 图 11-14 添加 方法 后 的 运行 结果 


添加 UpdXMLValue 方法 后 的 运行 结果 如 图 11-15 所 示 。 
添加 DelXMLValue() 方 法 后 的 运行 结果 如 图 11-16 所 示 。 


11-15 ”修改 后 的 结果 11-16 ”删除 后 的 结果 


11.3.4 ”实例 分 析 


ee 


在 删除 DelXMLValue 方法 中 ,我 们 使 用 RemoveAttribute 来 移 除 属性 值 ,还 使 用 RemoveAll 
来 移 除 该 节点 ，RemoveAll 表示 移 除 当 前 节点 的 所 有 属性 和 子 节点 ， 不 移 除 默 认 属 性 。 在 使 用 
RemoveAll 时 ， 必 须要 指定 其 属性 值 ， 否 则 无 效 。 


mS > 
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11.4” 自 定义 XML 序列 化 


序列 化 就 是 将 对 象 转换 成 易于 传输 形式 的 过 程 。 为 了 方便 存储 和 传输 数据 ， 我 们 将 一 个 对 
象 的 公共 域 和 属性 保存 为 XML 格式 的 过 程 就 被 称 为 XML 序列 化 ， 也 可 称 为 XML 串 行 化 。 


A 
加 视频 教学 : 光盘 /videos/11/ 自 定义 XML 序列 化 .avi 图 长 度 :10 分钟 


.NET Framework 中 的 XmlSerializer 类 为 我 们 提供 了 XML 序列 化 的 功能 。 XmlSerializer 类 
位 于 System.Xml.Serialization 命名 空间 下 ， 它 可 以 将 一 个 对 象 串 行 化 为 XML 格式 。 下 面 就 详 
细 讲 解 XmlSerializer 类 如 何 进行 XML 序列 化 。 

1. XmlSerializer 


XML 序列 化 的 核心 是 XmlSerializer 类 ,该 类 最 重要 的 两 个 方法 是 Serialize0 和 Deserialize() 
方法 。Serialize 方法 可 以 实现 XML 序列 化 ，Deserialize 方法 可 以 实现 XML 反 序 列 化 。 

要 想 对 一 个 对 象 进行 序列 化 ， 可 以 在 它 的 前 面 加 上 [SerializableO] 属 性 ， 它 适用 整个 类 ， 表 
示 整 个 类 都 支持 序列 化 。 另 外 ， 还 有 [NonSerializabled0] 属 性 ， 它 适用 于 标 有 [Serializable0] 的 
类 中 的 字段 ， 如 果 要 被 序列 化 的 类 中 有 某 个 字段 不 想 被 序列 化 ， 只 需要 在 该 字段 前 添加 
[NonSerializabled0] 属 性 即 可 。 除 了 这 两 个 属性 外 ,还 有 一 些 属性 控制 XmlSerializer 类 进行 XML 
序列 化 ， 如 表 11-3 所 示 。 


表 11-3 ”控制 XmlSerializer 执行 的 属性 


属 性 说 明 
用 于 识别 作为 XML 文件 根 元 素 的 类 或 者 结构 ， 可 以 用 它 把 一 个 元 素 名 设置 为 根 
[XmlRoot] 元 素 
[XmlElement] 当 公 有 的 属性 或 者 字段 可 以 作为 一 个 元 素 被 串 行 化 到 XML 结构 中 时 使 用 
[XmlAttribute] 当 公有 的 属性 或 者 字段 可 以 作为 一 个 属性 被 串 行 化 到 XML 结构 中 时 使 用 
[xmirgnore] 当 公有 的 属性 或 者 字段 不 包括 在 串 行 化 的 XML 结构 中 时 使 用 
[XmlArray] 当 公有 的 属性 或 者 字段 可 以 作为 一 个 元 素数 组 被 串 行 化 到 XML 结构 中 时 使 用 
[xmlAmayrteml 用 于 识别 可 以 放 在 一 个 串 行 化 数组 中 的 类 型 
2. 基本 序列 化 


序列 化 又 分 为 基本 序列 化 和 定制 序列 化 。 

基本 序列 化 是 指 .NET Framework 自动 地 对 对 象 进 行 序列 化 操作 。 只 需要 相应 的 对 象 拥有 
[SerializableO] 属 性 就 可 以 了 。 使 用 这 种 方法 ， 我 们 可 以 通过 [NonSerializabledO] 属 性 对 每 个 字 
段 进行 精确 控制 ， 不 想 被 序列 化 的 字段 只 需要 添加 [NonSerializabled0] 属 性 即 可 。 例 如 下 面 所 
示 的 代码 : 


using System; 


using System.Collections.Generic; 


< 人 —— 
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using System.Linqg; 
using System.Web; 
using System.Xml.Serialization; 
/// <summary> 
///Books 的 摘要 说 明 
/// </summary> 
[Serializable()] 
[XmlRoot ("Books")] 
public class Books 
‘ 
public Books() { } 
[XmlElement ("BookName")] 
private string name; 
public string Name 
{ 
get { return name; } 
set { name = value; } 
} 
[XmlElement ("Author")] 
private string author; 
public string Author 
{ 
get { return author; } 
set { author = value; } 
1 
[NonSerialized] 
[XmlElement ("bookContent")] 
private string content; 
public string Content 
{ 
get { return content; } 
set { content = value; } 


¥ 
这 段 代码 序列 化 后 显示 的 结果 如 下 : 


<Books> 

<BookName> 返 回 的 值 </BookName> 
<Ruthor> 返 回 的 值 </Author> 
</Books> 


因为 content 字段 加 了 [NonSerializabled0] 属 性 ， 所 以 并 没有 输出 。 


全 |  xMr 序列 化 只 能 序列 化 公共 类 、 公 共 字段 和 公共 属性 。 


3. 定制 序列 化 
很 明显 ， 使 用 基本 序列 化 自动 对 对 象 进行 序列 化 操作 ， 并 不 能 很 灵活 地 进行 控制 。 所 以 我 
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们 要 使 用 定制 序列 化 ， 这 样 就 能 够 精确 地 确定 哪个 字段 需要 序列 化 ， 以 及 怎样 进行 序列 化 。 
使 用 定制 序列 化 ， 首 先 需 要 添加 [SerializableO] 属 性 ， 然 后 还 需要 实现 ISerializable 接口 ， 
该 接口 声明 如 下 所 示 : 


public interface ISerializable 
t 


void GetObjectData (SerializationInfo info, StreamingContext context); 


} 


该 接口 位 于 System.Runtime.Serialization 命名 空间 下 。ISerializable 接口 只 有 一 个 
GetObjectData0 方 法 ， 该 方法 的 主要 作用 是 为 了 将 目标 对 象 序列 化 所 需 的 数据 填充 到 


SerializationInfo。 
例如 ， 我 们 可 以 通过 下 列 代 码 来 了 解 怎 样 定制 序列 化 。 


using System; 
using System.Collections.Generic; 
using System.Linqg; 
using System.Web; 
using System.Runtime.Serialization; 
/// <summary> 
///students 的 摘要 说 明 
/// </summary> 
[Serializable()] 
public class Student : ISerializable 
{ 
public string name = null; 
public int age = 0; 
public bool sex = true; 
public Student () 
{ 
} 
protected Student (SerializationInfo info, StreamingContext context) 
{ 
name = info.GetSstring ("name"); 
age info.GetInt32 ("age"); 
Sex info .GetBoolean ("sex"); 


1 


void ISerializable.GetObjectData (SerializationInfo info, StreamingContext 
context) 


| 
info.AddValue ("name", name); 
info.AddValue ("age", age); 
info.AddValue ("sex", sex); 


} 


可 以 看 到 ， 本 例 中 所 声明 的 三 个 字段 都 是 公共 的 ， 且 具有 不 同类 型 。 但 是 在 创建 的 
GetObjectData() 方 法 中 只 需 直接 调用 AddValue0 方 法 即 可 ， 因 为 AddValue0 方 法 带 有 所 有 标准 
类 型 的 重 载 方法 。 
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11.5 ”常见 问题 解答 


11.5.1 关于 XML 文件 写 入 的 问题 


关于 XML 文件 写 入 的 问题 。 
网 络 课堂 : http://bbs.itzcn.comy/thread-15441-1-1.html 


我 有 一 个 XML 文件， 代码 如 下 : 


<?xml] version="1.0" encoding="utf-8" ?> 
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > 
<session-factory name="SeNet .Base.NHibernate"> 


<!-- properties --> 

<property name="connection.connection string">0123456</property> 
<!-— mapping files --> 

<!-- are now optional 


<mapping file="ABC.hbm.xml" /> 
<mapping resource="NHibernate.DomainModel.Simple.hbm.xml" 
assembly="SeNet .BPZS.Entity" /> 
一 -> 
<mapping assembly="SeNet .BPZS.Entity" /> 
</session-factory> 
</hibernate-configuration> 


如 果 我 想 修改 里 面 的 <property name="connection.connection_string">0123456</property> 为 


<property name="connection.connection_string">789123</property>， 我 应 该 怎么 做 ? 
如 果 我 按照 以 下 方式 修改 : 


string retxml = 
"<property>name='connection.connection string'>0123456</property>"; 
// 此 处 省 略 

XmlDocument doc = new XmlDocument () 7 
doc.Loadxm] (etXml) 7 
XmlNodeList nodes = doc.GetElementsByTagName ("property ") 7 
nodes [0] .InnerText = "789123"7 
doc.Save ("XMLFilel .xml"); 


则 会 显示 “未 将 对 象 引用 设置 到 对 象 的 实例 ”的 错误 。 若 按照 以 下 方式 修改 : 


XmlDocument doc = new XmlDocument (); 

doc.LoadXxm] ("XMLFilel .xml"); 

XmlNodeList nodes = doc.GetElementsByTagName ("property "); 
nodes [0] .InnerText = "789123"7 

doc.Save ("XMLFilel .xml"); 


这 样 修改 之 后 ， 显 示 的 错误 为 “ 根 级 别 上 的 数据 无 效 ”。 
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怎么 办 ? 
【解决 办 法 】 
可 以 将 代码 改写 如 下 : 
string 
retXml="<property>name='connection.connection string'>0123456</property>"; 
// 此 处 省 略 
XmlDocument doc = new XmlDocument () 7 
doc.LoadXml (retxml); 
XmlNodeList nodes = doc.GetElementsByTagName ("property ") 7 
nodes [0] .InnerText = -1809123"? 
doc.Save ("XXX.xml"); 


11.5.2 Google 地 图 XML 的 写 入 问题 


回 删 Google 地 图 XML 的 写 入 问题 。 
网 络 课堂 : http://bbs.itzen.com/thread-15442-1-1.html 


Sa 


XmlDocument doc = new XmlDocument (); 

doc.Load (Server.MapPath ("~/GoogleMap article.xml")); 
XmlNode n = doc.SelectSingleNode("/urlset/url/loc"); 
n.Innerxml = this.TextBoxl.Text; 

doc.Save (Server.MapPath ("~/GoogleMap article.xml")); 


此 段 代码 要 写 入 GoogleMap_article.xml 文件 。 
这 个 文件 的 内 容 如 下 : 


<?xml Version="1.0" encoding="UTF-8"?> 

<urlset xmlns="http://www.google.com/schemas/sitemap/0.84"> 
ne 

<loc>http://www.tjanju.cn</loc> 

</url> 

</urlset> 


可 是 问题 来 了 ， 写 不 进去 。 只 有 改 成 : 


<urlset> 

<url> 
<loc>http://www.tjanju.cn</loc> 
</url> 

</urlset> 


才 可 以 写 进去 ， 可 是 写 进去 了 吧 ， 又 不 能 追加 ， 我 要 的 是 每 次 追加 一 行 。 


<url> 
<loc>http://www.tjanju.cn</loc> 
</url> 


< 
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【解决 办 法 】 
这 个 很 简单 。 我 直接 给 你 实现 了 ， 看 看 下 面 的 代码 吧 : 


XmlDocument doc = new XmlDocument (); 

doc.Load (Server.MapPath ("~/GoogleMap article.xm]l")); 
XmlNode node = doc.DocumentElement.ChildNodes[0] .Clone(); 
XmlNode n = doc.SelectSsingleNode("/urlset/url/loc"); 
n.InnerText = TextBoxl.Text; 

doc.DocumentElement .AppendChild (node); 

doc.Save (Server.MapPath ("~/GoogleMap article.xml")); 


11.5.3 ”在 XML 指定 位 置 写 入 


在 XML 指定 位 置 写 入 。 

网 络 课堂 : http:Wbbs.itzcn.conythread-15443-1-1.html 

我 有 一 段 代码 如 下 : 

XmlDocument xd = new XmlDocument (); 

xd.Load (AppDomain.CurrentDomain.BaseDirectory+"web.config"); 
XPathNavigator xn = xd.CreateNavigator(); 


XPathNodeIterator xni = xn.Select ("configuration/connectionstrings"); 
XmlNode x = ((IHasXxmlNode)xni.Current) .GetNode () 7 


了 往 下 不 会 写 了 。 
我 想 在 web.config 中 的 “<connectionStrings></connectionStrings>” 里 写 入 下 面 内 容 : 


tm 


<add name="connstring" 
connectionstring="server=.;database=tempdb;uid=sa;pwd=sa"/> 

希望 高 手 们 能 把 你 们 的 解决 方案 贴 在 下 面 。 

【解决 办 法 】 

我 以 前 公司 研究 了 几 个 月 的 XML， 基 本 所 有 格式 都 能 写 出 来 。 不 懂得 都 可 以 问 我 ， 在 节 


点 里 加 下 级 节点 : 


XmlNode Add= xd.CreateNode ("element", "add", " 
xni.Appendchild(aAdd) 7 

CreateRAttribute (Rdd， "name", "connstring"); 
CreateAttribute (Add, "connectionstring", 
"server=.;database=tempdb;uid=sa;pwd=sa"); 


往 节点 加 属性 : 


CreateAttribute (xzni， "name"，" 张 小 华 ") 7 
public XxmlAttribute CreateAttribute (XmlNode node, string attributeName, string 


value) 
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XmlDocument doc = node.OwnerDocument; 
XmlAttribute attr = null; 
attr = doc.CreateAttribute (attributeName); 
attr.Value = value; 
node.Attributes.SetNamedItem(attr); 
return attr; 

} 

catch (Exception err) 

| 
string desc = err.Message; 
return null; 


11.6 习 题 
一 、 填 空 题 
(1) 读 取 XML 文档 的 4 种 方式 分 别 是 、 使 用 XML 控件 、 使 用 DOM 技术 和 


使 用 DataSet 方 式 读 取 。 
(2) 使 用 XML 控件 读 取 XML 文档 时 要 将 XML 文档 的 路 径 赋 给 XML 控件 的 
属性 。 
(3) 使 用 定制 序列 化 必须 要 实现 的 接口 是 
(4) 如 果 在 要 序列 化 的 某 个 类 中 ， 有 一 个 字段 不 需要 序 列 化 ， 只 需要 在 该 字段 前 添加 
属性 即 可 。 
二 、 选 择 题 
(1) 下 列 关于 XML 特性 的 描述 中 ， 不 正确 的 一 项 是 
A. XML 是 纯 文 本 格式 ， 与 平台 无 关 
B. XML 是 可 扩展 的 、 自 定义 的 文档 ， 有 利于 不 同系 统 定义 不 同 的 标准 文档 
C. XML 将 文档 的 数据 、 结 构 和 实现 方式 结合 在 一 起 
D. XML 的 数据 存储 方式 不 受 显 示 格式 的 制约 
(2) 使 用 XmlTextWriter 方式 创建 XML 文档 时 ， 如 果 想 为 节点 添加 一 个 属性 ， 我 们 可 以 
使 用 XmlTextWriter 的 方法 。 
A. WriteAttributeString 
B. WriteElementString 
C. WnteComment 
D. WnteStartAttribute 
(3) 下 列 不 属于 XMLReader 的 三 个 派生 类 。 
A. XmlNodeReader 
B. XmlValueReader 
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XmlValidatingReader 
XmlTextReader 


(4) 下 列 关 于 XML 序列 化 的 描述 正确 的 一 项 是 


A. 
B 
C. 
D. 


XML 序列 化 只 能 序列 化 公共 类 、 公 共 字 段 和 公共 属性 
使 用 基本 序列 化 可 以 完全 控制 序列 化 和 反 序列 化 的 行为 
定制 序列 化 可 以 不 用 实现 ISerializable 接口 

基本 序列 化 也 能 实现 ISerializable 接口 


三 、 上 机 练习 

上 机 练习 1: 实现 宠物 信息 展示 ， 以 及 动态 添加 宠物 信息 。 

以 11.3 节 的 实例 为 基础 ， 实 现在 页 面 显 示 宠 物 信息 ， 如 图 11-17 所 示 。 单 击 【添加 信息 】 
链接 到 AddPet.aspx 页 面 ， 实 现 动态 添加 信息 到 XML 文档, 如 图 11-18 所 示 。 单 击 【查看 添加 】 


按钮 回 到 Default.aspx 页 面 ， 查 看 新 添加 的 信息 。 


https[/ losalhazstz2T13Xshangjirpet/addpret-asp -| 口 [X| 


GO Be 司 可 区 


请 收 妆 天 磋 htw:/1lhcahost2r13/shangji-?ev/Dsfualt 请 收 记 天 hy /fleabost.2T13/ hugli-pe /Madet. 


宠物 信息 


可 可 


petnameage pettype birth master 和 P23 
小 徘 。 3 拉 布 拉 多 大 加 拿 大 Alen ee 
里 味 ” 2 波斯 首 ”阿富汗 Liy | 


阿拉 斯 加 雪 楼 大 


， 阿拉 斯 加 
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图 11-17 显示 宠物 信息 图 11-18 ”添加 宠物 信息 


内 容 摘 要 : 


在 本 章 之 前 我 们 学 习 了 如 何 开发 一 个 Web 服务 。 事 实 上 ， 在 实际 开发 中 ， 有 很 多 Web 服 
务 并 不 需要 我 们 亲自 动手 编写 。 比 如 天 气 查询 ， 我 们 的 网 站 需要 展示 和 查询 天 气 情况 ， 如 果 靠 
我 们 自己 去 编写 ， 会 非常 麻烦 ， 怎 么 解决 呢 ? 这 时 就 用 到 第 三 方 Web 服务 了 ， 在 我 们 的 网 站 
中 只 需要 添加 Web 服务 的 引用 就 可 以 了 。 


学 习 目标 : 


熟练 使 用 第 三 方 Web 服务 实现 验证 码 功能 

熟练 使 用 第 三 方 Web 服务 查询 手机 号 码 归 属地 
熟练 使 用 第 三 方 Web 服务 查询 也 地 址 所 在 地 
熟练 使 用 第 三 方 Web 服务 查询 邮政 编码 

熟悉 掌握 第 三 方 Web 服务 查询 火车 班次 

熟悉 掌握 第 三 方 Web 服务 查询 各 个 城市 天 气 状况 


12.1 实现 后 台 登 录 时 的 验证 码 


我 们 在 逛 论坛 或 社区 时 ， 经 常会 看 到 登录 或 发 帖 时 需要 输入 验证 码 的 文本 框 ， 使 用 验证 码 
是 防止 网 站 被 恶意 攻击 的 有 效 手 段 之 一 。 可 是 ， 如 果 不 会 编写 验证 码 该 怎么 办 呢 ? 别 急 ， 我 们 
可 以 在 网 上 找到 第 三 方 提供 的 验证 码 Web 服务 ， 将 它 引 入 我 们 的 项 目 就 可 以 了 ， 下 面 就 让 我 
们 来 学 习 如 何 使 用 第 三 方 提供 的 Web 服务 吧 。 


9 
,视频 教学 ， 光盘/videos/12/ 实 现 后 台 登 录 的 验证 码 .avi 长度: 11 分 名 


12.1.1 实例 描述 


最 近 在 写 一 个 后 台 登 录 系 统 ， 为 了 防止 被 恶意 登录 或 暴力 破解 ， 决 定 添加 一 个 验证 码 ， 可 
是 不 会 写 验证 码 ， 只 好 在 网 上 找到 一 个 提供 验证 码 的 第 三 方 Web 服务 。 下 面 就 来 和 大 家 一 起 
分 享 如 何 使 用 第 三 方 Web 服务 。 


12.1.2 ”实例 应 用 


【 例 12-1】 实现 后 台 登 录 时 的 验证 码 
(1) 打开 Microsoft Visual Studio 2010, 新 建 一 个 ASP.NET 项 目 , 并 为 项 目 添加 Web 引用 。 
第 三 方 Web 服务 的 URL 为 “http://webservice.webxml.com.cn/WebServices/ValidateCodeWeb 
Service.asmx”， 修 改 Web 引用 名 为 ValidateCodeWS， 如 图 12-1 所 示 。 


请 定位 到 提供 Yey 服务 的 EL， 然后 音 十 “添加 引用 ”,， 添加 位 于 访 UL 上 的 所 有 可 有 服务 
[ca EA] 


MLD: Be /foboervicn nbn em evloervice/yidat | 


] 司 ] 位 于 此 viL 上 的 Wb 服务 加 
ValidateCodeWebsSe 1 TR 


-vaiatcoialaeaviee 


12-1 添加 Web 引用 


(2) 在 项 目 中 添加 页 面 Login.aspx 和 ValidateCode.aspx。ValidateCode.aspx 页 面 用 于 生成 
验证 码 ， 在 ValidateCode.aspx.cs 页 面 中 添加 如 下 代码 : 


public partial class ValidateCode : System.Web.UI.Page 
和 
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ValidateCodeWs .ValidateCodeWebService vcws = new 


ValidatecodeWS .ValidateCodeWebService(); // 实 例 化 Web 服务 对 象 
protected void Page Load (object sender, EventArgs e) 
i 


if (Request.Params["validateDate"] !=null1) // 接 收 传 来 的 参数 

{ 
int i=Int32.Parse( Request.Params["validateDate"] .ToSstring()); 
Response.ContentType = "image/Png"; 
byte[] b = vcws.enValidateByte(i.Tostring()); 
Response.BinaryWrite(b); 


} 


“Request.Params["validateDate"] ”表示 在 Login.aspx 页 面 里 随机 生成 的 对 象 ， 将 它 作 为 参 

数 传 给 ValidateCode.aspx 页 面 。 在 ValidateCode.aspx 页 面 里 实例 化 Web 服务 对 象 ， 以 

“RequestParams["validateDate"]” 为 参数 ， 返 回 一 个 二 进 制 字符 串 ， 并 且 将 它 写 入 HTTP 输 
出 流 。 

(3) 在 login.aspx.cs 页 面 ， 


添加 如 下 代码 ， 实 现 登 录 功 能 和 验证 码 的 生产 : 


public partial class ValidatePicture : System.Web.UI.Page 
{ 
protected void Page Load(object sender, EventArgs e) 
{ 
if (!IsPostBack) 
{ 
Random rd = new Random(); // 实 例 化 随机 对 象 
string str = rd.Next (1000, 9999) .ToString() 7 
Imagel.ImageUr1 = "ValidateCode.aspx?validateDate=" + str; 
// 生 成 随机 验证 码 图 片 


Session["validateDate"] = str; 


} 
protected void Imagel Click(object sender, ImageClickEventArgs e) 


// 换 一 张 图 片 


Random rd = new Random(); // 实 例 化 随机 对 象 
string str = rd.Next(1000, 9999) .Tostring(); 
Imagel .ImageUr1 = "ValidateCode.aspx?validateDate=" + str; 
// 生 成 随机 验证 码 图 片 
Session["validateDate"] = str; 
| 
protected void btnOK Click(object sender, EventArgs e) 
{ 
if (txtUser name.Value.Trim() == "admin" g&& txtUser pwd.Value.Trim() == 
"admin") 


if (Session["validateDate"] -ToString() == 
txtValidateCode.Value.Trim()) 
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} 


{ 
ClientScriptManager csm = Page.ClientScript; 
Csm-RegisterStartupScript (GetType(), "", "<script>alert 
(' 登录 成 功 ! ') ;</script>"); 
} 
else 
{ 
ClientscriptManager csm = Page.Clientscript; 
csm.RegisterstartupSscript (GetType(), "", "<script>alert 
(' 登 录 失 败 ! ') ;</script>"); 


首先 在 login.aspx.cs 页 面 的 Load 事件 里 ， 实 例 化 随机 对 象 ， 并 且 生 成 一 个 1000 一 9999 之 
间 的 随机 数 ， 将 随机 数 作为 参数 传递 给 ValidateCode.aspx 页 面 ， 并 且 将 它 保 存 到 Session 里 。 
同时 ， 为 了 实现 点 击 图 片 换 一 张 图 片 的 功能 ， 我 们 将 验证 码 放 在 一 个 ImageButton 控件 中 ， 并 
且 在 ImageButton 控件 的 单 击 事件 里 添加 和 Load 事件 同样 的 代码 。 最 后 , 在 btonOK 登录 按钮 


的 Click 


事件 里 ， 验 证 输入 的 验证 码 和 生成 的 验证 码 是 否 相同 ， 即 将 txtValidateCode 文本 框 里 


输入 的 验证 码 和 Session 里 保存 的 验证 码 进行 比较 。 


12.1.3 ”运行 结果 


运行 Login.aspx 页 面 , 在 浏览 器 中 打开 该 页 面 , 可 以 看 到 带 有 验证 码 的 登录 页 面 , 如 图 


所 示 。 


js 


2-2 


用 户 名 称 ， [aomn 
用 户 密码 ，|eeeee 


12-2 ”有 验证 码 的 登录 页 面 


单 


验证 码 图 片 ， 可 更 换 验证 码 。 输 入 用 户 名 称 “admin” 和 用 户 密码 “admin”， 将 生成 


的 验证 码 输 入 到 文本 框 中 ， 单 击 【 登 录 】 按钮 ， 验 证 成 功 ， 显 示 登 录 成 功 对 话 框 ， 运 行 结果 如 
12-3 所 示 。 


mtD >> 


12-3 ”验证 成 功 的 登录 页 面 


12.1.4 ”实例 分 析 


Sammwi 


本 实例 中 的 ValidateCode.aspx 页 面 负责 接收 传递 过 来 的 数据 ， 并 调用 第 三 方 Web 服务 提 
供 的 接口 enValidateByte()， 返 回 的 验证 码 图 片 字 节 流 被 Login.aspx 页 面 的 ImageButton 控件 接 
收 ， 然 后 显示 在 界面 上 。 本 例 使 用 的 第 三 方 Web 服务 还 提供 了 很 多 接口 来 实现 验证 码 的 功能 ， 
读者 可 以 试 一 下 。 


12.2 手机 号 码 归 属地 查询 


前 面 我 们 对 第 三 方 Web 服务 的 应 用 有 了 一 个 简单 的 了 解 ， 它 不 但 能 减少 网 站 开发 人 员 的 
工作 量 ， 还 能 给 我 们 的 生活 带 来 便利 。 下 面 我 们 一 起 去 学 习 使 用 手机 号 码 归 属地 查询 的 Web 
服务 。 


-人 视频 教学 : 光盘 /videos/12/ 手 机 号 码 归 属地 查询 .avi 国度 : 5 分 钟 


12.2.1 实例 描述 


有 一 段 时 间 ， 经 常 接 到 一 个 陌生 的 电话 ， 接 通 后 对 方 却 一 直 不 说 话 ， 因 为 害怕 是 公司 的 客 
户 ， 所 以 再 打 来 的 时 候 又 不 敢 不 接 。 于 是 自己 以 前 写 的 一 个 手机 号 码 归属 地 查询 有 了 用 武之 
地 ， 查 询 后 才 知 道 ， 这 个 号 码 是 新 疆 的 ， 公 司 在 新 疆 根本 没 业务 啊 ， 赶 紧 把 这 个 号 码 设置 成 拒 
接 号 码 。 

学 到 的 东西 总 算是 用 到 了 日 常生 活 中 ， 感 觉 很 有 成 就 感 ， 下 面 我 们 一 起 去 看 看 这 个 实例 ， 
学 会 后 也 能 向 同学 和 朋友 炫 炮 一 下 。 


< 


二 服务 开发 学 习 实录 . 


12.2.2 ”实例 应 用 


【 例 12-2】 手机 号 码 归属 地 查询 
(1) 打开 上 节 创 建 的 ASP.NET 项 目 ， 首先 添加 本 节 所 需 的 第 三 方 Web 服务 引用 ，Web 服 
务 的 URL 为 “http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx”，Web 引用 
名 为 “mobileService”。 
(2) 添加 TelephoneSearch.aspx 页 面 ， 前 台 部 分 代码 如 下 所 示 : 


<table width="600"” border="0" align="center" cellpadding="1" cellspacing="1" 
bgcolor="#a9cfe4"> 


ED 
<td height="32" align="center" bgcolor="#a9cfe4" class="titlel"> 
手机 号 码 归属 地 查询 
</td> 
< 
SE 


<td height="45" align="center" bgcolor="#FFFFFF" valign="middle"> 
手机 号 码 (最 少 前 七 位 数字 ) : <asp:TextBox ID="txtMobileNum" runat="server" 
MaxLength="11"></asp:TextBox> 
<asp:Button ID="btnSsearch" runat="server" OnClick="btnSearch Click" Text=" 
查询 " Width="49px" /> 
<br /> 
<asp:UpdateProgress ID="UpdateProgressl" runat="server"> 
<ProgressTemplate> 
<img src="images/loading.gif" alt="Loading... ... 0 
</ProgressTemplate> 
</asp:UpdateProgress> 
<asp:Label ID="lblShow" runat="server"></asp:Label> 
</td> 
</tr> 
</table> 


因为 涉及 到 Web 访问 ， 有 时 候 在 查询 结果 出 来 前 需要 很 长 时 间 ， 为 了 防止 页 面 长 时 间 没 
有 响应 ， 在 这 里 我 们 利用 Ajax 技术 ， 放 上 一 个 进度 条 ， 使 页 面 在 结果 出 来 前 有 一 个 缓冲 ， 在 
这 里 涉及 到 的 Ajax 技术 不 再 详细 讲解 。 

(3) 在 btmSearch 按钮 的 Click 事件 里 添加 如 下 代码 : 


protected void btnsearch Click(object sender, EventArgs e) 


{ 
mobileService.MobileCodeWs mc = new mobileService.MobileCodeWs () 7 


// 实 例 化 Web 服务 对 象 
String showMsg = mc.getMobileCodeInfo (txtMobileNum.Text.Trim(), ""); 

// 查 询 输入 手机 号 码 的 归属 地 
lblshow.Text = "手机 号 码 : ”+ txtMobileNum.Text.Trim() + "<br/>"” + "归属 地 " 


+ showMsg.Substring (txtMobileNum.Text.Length); 
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12-4 ”手机 号 码 归属 地 查询 结果 


12.2.4 ”实例 分 析 


Bam 


本 实例 中 调用 了 第 三 方 Web 服务 提供 的 getMobileCodeInfo() 方 法 ， 只 要 手机 号 码 (最 少 前 
7 位 ) 作 为 参数 ， 便 能 查询 出 手机 的 归属 地 。 方法 的 参数 和 返回 类 型 在 提供 此 服务 的 Web 服务 
上 有 详细 描述 。 输入 参数 : mobileCode = 字符 串 (手机 号 码 , 最 少 前 7 位 数字 ), userID= 字 符 串 ( 商 
业 用 户 ID)，userID 可 以 为 空 ; 返回 数据 : 字符 串 (手机 号 码 : 省 份 城市 手机 卡 类 型 )。 


12.3 IP 地 址 查询 


通过 上 节 课 的 学 习 ， 相 信 大 家 对 第 三 方 Web 服务 有 了 更 深入 的 了 解 ， 也 会 更 有 兴趣 去 学 
习 第 三 方 Web 服务 ， 因 为 它 能 使 我 们 有 成 就 感 。 既 然 有 了 学 习 兴 趣 ， 咱 们 就 赶紧 开始 这 节 课 
的 学 习 吧 。 


已 和 视频 教学 : 光盘 /videos/12/IP 地 址 查询 .avi 长度: 5 分 钟 
12.3.1 实例 描述 
刚 开 始 接触 互联 网 的 时 候 ， 浏 览 一 些 门 户 网 站 ， 上 面 总 是 显示 着 我 所 在 的 城市 ， 而 且 后 面 


跟着 就 是 天 气 状况 ， 很 好 奇 那些 门户 网 站 怎么 知道 我 们 这 些 浏览 者 在 哪个 城市 ， 他 们 就 不 怕 把 
我 们 的 地 址 弄 错 吗 ? 后 来 学 习 Web 服务 才 明 白 ， 我 的 担心 实在 是 多 余 ， 要 知道 浏览 者 在 哪个 


< 


@ 服务 开发 学 习 实录 .… 


城市 ， 原 来 是 如 此 的 简单 。 


12.3.2 ”实例 应 用 


【 例 12-3】 IP 地 址 查询 
(1) 打开 12.1 节 创 建 的 项 目 , 添加 查询 人 P 地 址 所 需 的 第 三 方 Web 服务 引用 ,Web 服务 的 
URL 为 “http://webservice.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx”, Web 
引用 名 为 “IpAddressSearchWebService”。 
(2) 添加 名 为 PSearch.aspx 的 页 面 ， 页 面前 台 添 加 txtIP 文本 框 控件 ， 用 于 输入 IP 地 址 ， 
btnSearch 按钮 用 于 查询 ，ID 为 lblShow 的 Label 控件 用 于 显示 查询 结果 。 
(3) 在 IPSearch.aspx 页 面 的 Load 事件 里 添加 如 下 代码 ， 显 示 本 机 IP 地 址 所 在 地 : 


IpAddressSearchWebService.IpAddressSearchWebService ipWS 
= new IpAddressSearchWebService.IpAddressSearchWebsService(); 
protected void Page Load(object sender, EventArgs e) 
下 
string[] IPStr =ipWS.getGeoIPContext (); // 获 取 本 机 IP 信息 
lblShow.Text =" 您 当前 的 IP 地 址 是 : "+ IPStr[0]+" 来 自 : "+IPStr[1]+"<br>"; 
} 


(4) 在 bmSearch 按钮 的 Click 事件 里 添加 如 下 代码 , 查询 输入 到 文本 框 中 的 了 P 的 所 在 地 : 


protected void btnSearch Click(object sender, EventArgs e) 
{ 
string[] IPStr =ipWS .getCountryCityByIp (txtIP.Text.Trim()); 
// 获 取 输 入 的 IP 地 址 的 信息 
lblshow.Text += "您 输入 的 IP 地 址 是 : " + IPStr[0] + "来 自 ， " + IPStr[1]; 


12.3.3 ”运行 结果 


运行 IPSearch.aspx 页 面 ， 输 入 测试 他， 查询 结果 如 图 12-5 所 示 。 


A 


ER 


12-5 ”IP 地 址 查询 结果 
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12.3.4 ”实例 分 析 


Cn 


本 实例 调用 了 第 三 方 Web 服务 提供 的 getGeoIPContext() 接 口 和 getCountryCityByIpO 接 口 。 
getGeoIPContext() 接 口 用 来 获取 本 机 的 卫 地 址 和 归属 地 ，getCountryCityByIp() 接 口 用 来 获取 输 
入 的 人 地 址 的 归属 地 .。 

把 Web 服务 的 URL 输入 到 浏览 器 的 地 址 栏 中 ， 可 以 查看 此 Web 服务 提供 的 方法 的 详细 
描述 。 


12.4 ”邮政 编码 查询 


随 着 网 络 技术 的 飞速 发 展 ， 我 们 越 来 越 依赖 网 络 带 给 我 们 生活 的 便利 。 可 是 ， 如 果 哪 天 我 
们 必须 要 用 到 原始 的 交流 方式 寄 信 给 对 方 时 ， 就 必须 知道 对 方 的 邮政 编码 了 ， 怎 么 能 快捷 地 知 
道 对 方 的 邮政 编码 呢 ? 在 本 节 中 ， 我 们 将 利用 第 三 方 Web 服务 向 大 家 展示 如 何 快捷 地 查询 对 
方 的 邮政 编码 。 


上 视频 教学 :光盘 /videowy12/ 邮 政 编码 查询 avi Ok 7 分 名 


12.4.1 实例 描述 


我 朋友 在 外 地 上 学 ， 本 来 平时 联系 的 时 候 都 是 用 聊天 工具 或 者 电子 邮箱 的 ， 可 是 前 段 时间 
朋友 学 校 全 校 禁 网 ， 没 办 法 ， 只 能 使 用 原始 的 书信 交流 。 可 是 ， 提 起 笔 写 完 信 后 傻眼 了 ， 邮 政 
编码 该 怎么 填 呀 ， 我 根本 就 不 知道 朋友 那 的 邮政 编码 呀 ， 哎 ， 欲 器 无 泪 呀 。 还 好 ， 某 段 时 间 做 
的 一 个 小 程序 帮 了 我 大 忙 ， 利 用 第 三 方 Web 服务 查询 邮政 编码 ， 这 些小 程序 真是 好 用 呀 ， 下 
面 就 来 看 看 怎么 实现 吧 。 


12.4.2 ”实例 应 用 


【 例 12-4】 邮政 编码 查询 
(1) 打开 12.1 节 创 建 的 项 目 ， 添 加 第 三 方 Web 服务 引用 ，Web 服务 的 URL 为 
“http://webservice.webxml.com.cn/WebServices/ChinaZipSearchWebService.asmx”, Web 引用 名 
为 “ChinaZipSearchWebServices”。 
(2) 添加 名 为 ZipSearch.aspx 的 页 面 ， 页 面前 台布 局 如 图 12-6 所 示 。 


549 


I 


m= > 


“该 闻 扩 编码 
个 按 迎 址 查询 《 迎 址 


图 12-6 ZipSearch.aspx 页 面前 台布 局 
ZipSearch.aspx 页 面 的 部 分 前 台 代 码 如 下 所 示 : 


<asp:RadioButtonList ID="RadioButtonListl" runat="server" 
OnselectedIndexChanged="RadioButtonListl SelectedIndexChanged" 
AutoPostBack="true"> 
<asp:ListItem Value="1"” Selected="True"> 按 邮政 编码 查询 (邮政 编码 一 一 ggt; 地 址 ) 
</asp:ListItem> 
<asp:ListItem Value="2"> 按 地 址 查询 (地 址 一 一 &gt; 邮 政 编码 ) </asp:ListItem> 
</asp:RadioButtonList> 
<div id="ByZip" runat="server"> 
输入 6 位 邮政 编码 : <asp:TextBox ID="txtZip" runat="server"></asp:TextBox> 
<asp:Button ID="btnSearchBYZip"” runat="server"” Text=" 查 询 " 
Onclick="btnSearchBYZip_Click"” /> 
<asp:RegularExpressionValidator ID="RegularExpressionValidatorl" 
runat="server"ControlToValidate="txtZip" ErrorMessage="x" 
ForeColor="#FF0066" 
ValidationExpression="\d{6}"></asp:RegularExpressionValidator> 
<br /> 
</div> 
<div id="ByAddress" visible="false" runat="server"> 
省 份 或 直辖 市 ，&nbsp; 
<asp:DropDownList ID="Province" runat="server" Style="margin-left: Opx" 
Width="]145px"> 
</asp:DropDownList> 
=r 
城市 /地 区 名 称 : 
<asp:TextBox ID="txtCity" runat="server" Width="145px"></asp:TextBox> 
<br /> 
街道 /乡镇 名 称 : 
<asp:TextBox ID="txtAddress" runat="server" 
Width="]45px"></asp:TextBox> 
<br /> 
<asp:Button runat="server" ID="btnsearchByAddress" Text=" 查 询 " 
OnClick="btnSearchByAddress Click" /> 


</div> 
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RadioButtonList 控 件 用 于 控制 两 个 层 ByZip 和 ByAddress 的 显示 和 隐藏 。 在 RadioButtonList 
控件 的 SelectedIndexChanged 事件 里 的 代码 如 下 : 


protected void RadioButtonListl1 SelectedIndexChanged (object sender, EventArgs e) 
{ 
if (RadioButtonList1.SelectedValue == "1" 
{ 
ByZip.Visible = true; 
ByAddress.Visible = false; 


} 
else if (RadioButtonListl.SelectedValue == "2") 


‘| 
ByZip.Visible = false; 
ByAddress.Visible = true; 


} 

在 该 Web 服务 中 ,查询 返回 的 数据 类 型 是 DataSet 数据 类 型 ， 所 以 还 需要 在 前 台 页 面 添加 
用 于 显示 查询 所 得 的 数据 的 数据 控件 ， 在 这 里 我 们 使 用 的 是 GridView 数据 控件 。 

(3) 下 面 是 页 面 Load 事件 的 数据 绑 定 ， 用 于 在 页 面 加 载 时 绑 定 省 份 的 下 拉 列 表 框 : 


ChinazZipSearchWebServices.ChinaZzipSearchWebService Chinazip = 
new ChinazZipSearchWebServices.ChinazZipSearchWebService(); 
protected void Page Load(object sender, EventArgs e) 
{ 

if (!IsPostBack) 


{ 
// 绑 定 省 份 下 拉 列 表 杠 


Province.DataSource = Chinazip.getSupportProvince(); 
Province.DataBind(); 


} 
(4) 接 下 来 是 按 输入 的 邮政 编码 查询 地 址 和 按 地 址 查询 邮政 编码 的 两 种 查询 方法 的 实现 
代码 : 


protected void btnSsearchByZip Click(object sender, EventArgs e) 


{ 
// 按 输入 的 邮政 编码 查询 地 址 


DataSet ds = Chinazip.getAddressByZipCode (txtZzip.Text.Trim(), 
GridViewShowAddress.DataSource = ds.Tables[0] .DefaultView; 
GridViewShowAddress.DataBind(); 


mr 


} 
protected void btnsearchByAddress Click(object sender, EventArgs e) 


{ 
Dataset ds = 
Chinazip.getZzipCodeByAddress (Province.SelectedValue, txtCity.Text.Trim(), 


ExtAaddress Text errimt 


// 根 据 地 址 获取 邮政 编码 


< 全 一 


GridViewShowAddress.DataSource = ds.Tables[0] .DefaultView; 
GridViewShowAddress.DataBind(); 


12.4.3 ”运行 结果 


运行 ZipSearch.aspx 页 面 ， 按 邮政 编码 查询 如 图 12-7 所 示 ， 按 地 址 查询 如 图 12-8 所 示 。 


12-8” 按 地 址 查询 


12.4.4 ”实例 分 析 


yr 


本 实例 中 调用 第 三 方 Web 服务 提供 的 getSupportProvince0 接 口 ， 返 回 它 支持 的 省 份 /城市 
信息 , getAddressByZipCode0 接 口 根据 输入 的 邮政 编码 返回 对 应 的 地 址 , getZipCodeByAddress() 
接口 根据 输入 的 地 址 返回 对 应 的 邮政 编码 。 使 用 RadioButtonList 控件 时 ， 要 想 实现 该 控件 的 
OnSelectedIndexChanged 事件 ， 必 须 先 设 定 属性 AutoPostBack 为 “true”， 表 示 当 选 定 内 容 更 
改 时 ， 自 动 回 发 到 服务 器 上 。 
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12.5 ”火车 车 次 查询 


出 行 是 一 个 大 问题 ， 如 果 我 们 要 坐 火车 的 话 ， 要 是 不 知道 坐 哪 次 车 ， 什 么 时 候 出 发 ， 什 么 
时 候 到 站 ， 那 可 就 糟糕 了 。 所 以 ,我 们 在 出 行 前 也 必须 要 了 解 所 有 火车 车 次 的 信息 ， 这 样 才 不 
至 于 在 临 出 发 时 手忙脚乱 。 

接 下 来 ， 就 教 给 大 家 一 个 简单 的 关于 火车 车 次 查询 的 程序 ， 快 点 跟着 我 来 学 习 吧 。 


视频 教学 : 光盘 /Videos/12/ 火 车 车 次 查询 .avi @ 度 : 5 分 名 


12.5.1 ”实例 描述 


前 段 时 间 我 朋友 要 出 差 去 上 海 ， 不 知道 要 坐 哪 趟 火车 去 ， 刚 好 我 在 做 一 个 关于 查询 火车 车 
次 的 程序 ， 利 用 了 第 三 方 Web 服务 ， 数 据 绝对 准确 ， 于 是 ， 借 花 献 佛 ， 也 算是 给 朋友 的 一 个 
离别 礼物 。 下 面 就 让 我 们 一 起 来 看 看 是 如 何 实现 的 吧 。 


12.5.2 ”实例 应 用 


【 例 12-5】 火车 车 次 查询 
(1) 打开 12.1 节 创 建 的 ASP.NET 项 目 ， 为 项 目 添加 本 节 所 需 的 第 三 方 Web 服务 引用 ， 
Web 服务 URL 为 “http://webservice.webxml.com.cn/WebServices/TrainTimeWebService.asmx”， 
Web 引用 名 为 “TrainTimeSearchWS”。 
(2) 添加 名 为 TrainTimeSearch.aspx 的 页 面 。 前 台 页 面 布局 如 图 12-9 所 示 。 代 码 略 。 


12-9 TrainTimeSearch.aspx 前 台 页 面 布局 


两 个 GridView 控件 分 别 绑 定 火车 车 次 和 站 站 查询 的 结果 。 
(3) 查询 按钮 的 单 击 事件 代码 如 下 所 示 : 


protected void btnsearch Click(object sender, EventArgs e) 
{ 

TrainTimeSearchWS .TrainTimeWebService ttws = new 
TrainTimeSearchWS .TrainTimeWebService(); 


if (TrainNum.Checked == true)// 按 火车 车 次 查询 
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@,. 服务 开发 学 习 实录 - 


string[] str =ttws.getSstationAndTimeByTrainCode 
(txtTrainNum.Value.Trim(),""); 
lblshow.Text = "车 次 : "+str[0]+", "; 
IbISNow Tezxt 1= 7 如 发 总 7 13tzD31 2 9 
lblShow.Text 
lblshow.Text += "终点 站 : " + str[5] + "，<br/>"; 
lblShow.Text += "到 达 时 间 : " + Se 
lblShow.Text += "里 程 : " + str[7] + "KM, "; 
lblShow.Text += "历时 时 间 : " + str[8]; 
GridView1l.DataSource = 
ttws.getDetailInfoByTrainCode (txtTrainNum.Value.Trim(), ""). 
Tables[0] .DefaultView; 
GridViewl .DataBind(); 
GridView2.Visible = false; 


GridViewl.Visible = true; 
lblSshow.Visible = true; 
} 
if (Trainzhanzhan.Checked == true)// 按 车 站 到 车 站 查询 
让 
GridView2.DataSource =ttws.getStationRndTimeBYStationName 
(txtChuFa2zhan.Value .Trim() ,txtDaoDa2zhan.Value.Trim()，"") 7 
GridView2.DataBind(); 


lblShow.Visible = false; 
GridView2.Visible = true; 
GridViewl .Visible = false; 


FOR 
六 os。 六 呈 本 


12-10 ”根据 火车 车 次 查询 结果 
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在 出 发 站 和 到 达 站 分 别 输入 城市 名 称 ， 单 击 查询 ， 查 询 结 果 如 图 12-11 所 示 。 


12-11 ”查询 结果 


12.5.4 ”实例 分 析 


sr 


本 例 中 ， 在 查询 按钮 的 单 击 事件 里 ， 我 们 根据 TrainNum 单 选 按钮 和 TrainZhanZhan 单 选 
按钮 是 否 被 选中 的 状态 ， 来 判断 执行 哪 种 查询 方式 。 如 果 选 择 的 是 火车 车 次 ， 则 使 用 第 三 方 
Web 服务 提供 的 getStationAndTimeByTrainCode() 方 法 ; 如 果 选 择 的 是 站 站 查询 ， 则 使 用 第 三 
方 Web 服务 提供 的 getStationAndTimeByStationName() 方 法 。 


12.6 天 气 查 询 


好 吧 ， 出 行 的 交通 问题 在 上 节 得 到 了 解决 ， 可 是 还 有 一 个 很 大 的 问题 ， 那 就 是 天 气 状 况 。 
本 来 高 高 兴 兴 地 去 旅游 了 ， 可 是 到 达 目 的 地 后 才 发 现 ， 阴 天 下 雨 的 ， 也 没 办 法 出 去 玩 ， 只 能 窝 
在 旅馆 里 ， 多 扫兴 呀 。 于 是 ， 本 节 就 教 大 家 写 一 个 关于 天 气 查 询 的 程序 ， 输 入 想 要 查询 天 气 的 
城市 ， 这 个 城市 未 来 三 天 的 天 气 情况 就 一 目 了 然 了 ， 很 方便 吧 ， 赶 快 来 看 看 吧 。 


忆 和 视频 教学 : 光盘 /videos/12/ 天 气 查询 .avi 加 长 度 : 7 分 钟 


12.6.1 ”实例 描述 


五 一 放假 了 ,我 和 家 人 商量 着 去 外 地 旅游 ， 因 为 不 知道 目的 地 的 天 气 状况 ， 也 不 知道 该 穿 
厚 点 还 是 薄 点 , 真 为 难 。 正 想 着 呢 ， 一 下 子 想起 来 前 段 时 间 做 的 一 个 程序 : 天 气 查 询 系统 ， 哈 ， 
这 样 就 简单 多 了 ， 输 入 城市 名 ， 天 气 状况 很 快 就 了 解 了 ， 而 且 关 于 这 个 城市 的 介绍 和 今日 指数 
都 很 详细 呢 。 


< 


12.6.2 ”实例 应 用 


【 例 12-6】 天 气 查 询 
(1) 打开 12.1 节 创建 的 ASPNET 项 目 ， 添 加 本 节 所 需 的 第 三 方 Web 服务 引用 ，Web 服 
务 的 URL 地 址 为 “http://webservice.webxml.com.cn/WebServices/WeatherWebService.asmx”， 
Web 引用 名 为 “weatherServices”。 
(2) 添加 名 为 Weather.aspx 的 页 面 ， 页 面前 台布 局 效果 如 图 12-12 所 示 。 


国内 外 主要 城南 3 天 天 气 预报 实 所 
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今日 实况 [abeli] 
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币 报 时 间 ， [Lobel7] 
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图 12-12 前 台 页 面 布局 


(3) Weather.aspx 页 面 有 两 个 下 拉 列 表 框 ， 分 别 表示 省 份 和 城市 ， 页 面 Load 事件 的 代码 
如 下 : 


weatherServices.WeatherWebService wws = new 
weatherServices.WeatherWebService(); // 初 始 化 WeatherWebservices 


protected void Page Load(object sender, EventArgs e) 
{ 
if (!IsPostBack) 
{ 
sheng.DataSource = wws.getSupportDatasSet () .Tables [0] .DefaultView; 
// 获 取 支 持 的 州 和 国内 省 份 数据 
sheng.DataValueField = "ID"; 
sheng.DataTextField = "Zone"; 
sheng.DataBind(); 


CityBind ("1"); // 默 认 省 级 行政 单位 “直辖 市 ” 
weather ("58367"); // 默 认 查 询 上 海天 气 状况 


在 页 面 加载 时 ， 绑 定 ID 为 “sheng” 的 下 拉 列 表 框 数据 。CityBind0 方 法 表示 根据 省 份 或 直 
辖 市 得 到 城市 数据 ， 并 绑 定 到 ID 为 “shi” 的 下 拉 列 表 框 。CityBind0 方 法 的 代码 如 下 : 


m= > 


// 根 据 选 定 的 省 份 获取 对 应 的 城市 

protected void CityBind(string zoneID) 

{ 
DataTable dt = wws.getSupportDataSet() .Tables[1]7 
DataView dv = new DataView (dt); 
dv.RowFilter = "ZoneID=" + zoneID; 
shi.DataSource = dv; 
shi.DataTextField = "Area"; 
shi.DataValueField = "AreaCode"; 
shi.DataBind(); 

} 


(4) 下 面 是 ID 为 “sheng” 的 下 拉 列 表 框 的 onselectedindexchanged 事件 的 代码 : 


protected void sheng_SelectedIndexCchanged (object sender, EventArgs e) 
{ 
CityBind(sheng.SelectedItem.Value.Trim() ) ;// 根 据 选 定 的 省 份 获取 对 应 的 城市 


下 拉 列 表 框 的 AutoPostBack 属性 需要 设 为 true。 
(5) 接 下 来 是 【查询 】 按 钮 的 单 击 事件 ， 代 码 如 下 : 
// 查 询 


protected void btnWeatherSearch Click(object sender, EventArgs e) 


// 获 取 城 市 天 气 信息 


weather (shi.SelectedItem.Value .Trim()) 7 
} 
private void weather(string city) 
{ 
string[] wa = wws.getWeatherbyCityName (city); 


Labell.Text = wa[10]7 

Label2.Text = wa[6] + "&nbsp;&nbsp;&nbsp;" +wa[5] +"&nbsp;&nbsp;&nbsp;" + 
wa[7]7 

Label3.Text = wa[3] + "gnbsp;&nbsp; &nbsp;" + wa[12] + "&nbsp; &nbsp; &nbsp;" 
+ wa[14]7 

Label4.Text = wa[18] + "&nbsp; &nbsp; &nbsp;" + wa[l7] + "&nbsp; &nbsp; &nbsp;" 
+ wa[19]; 

Label5.Text = wa[11]7 

Label6.Text = wa[22]7 

Label7.Text = wa[4]7 


Label8.Text = wa[0] + "/ "+ wa[lll; 

Imagel1 .ImageUI1 = "~/images/weather/" + wa[8]7 

Image2.ImageUIr1 = "~/images/weather/" + wa[9]7 

Image3.ImageUI1 = "~/images/weather/" + wa[15]7 

Image4.ImageUrl = "~/images/weather/" + wa[16]7 
+ wa[20]7 

Image6.ImageUI1 = "~/images/weather/" + wa[21]7 


Image5.ImageUrl "~/images/weather/" 


CityPhoto.ImageUrl = "http://www.cma.gov.cn/tqyb/img/city/" + wa[3]7 
CityPhoto.AlternateText = shi.SelectedItem.Text; 
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12.6.3 ”运行 结果 


运行 Weather.aspx 页 面 ， 结 果 如 图 12-13 所 示 。 
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图 12-13 天气 查询 结果 


12.6.4 ”实例 分 析 


a 


getWeatherbyCityName() 方 法 详解 : 参数 为 城市 中 文 名 称 (国外 城市 可 用 英文 ) 或 城市 代码 
(不 输入 默认 为 上 海 市 )， 如 : 上 海 或 58367， 如 有 城市 名 称 重复 请 使 用 城市 代码 查询 (可 通过 
getSupportCity 或 getSupportDataSet 获得 ); 返回 数据 : 一 个 一 维 数组 String(22), 共有 23 个 元 素 。 

String(0) 到 String(4): 省 份 ， 城 市 ， 城 市 代码 ， 城 市 图 片 名 称 ， 最 后 更 新 时 间 。String(S) 
到 String(11): 当天 的 气温 ， 概 况 ， 风 向 和 风力 ， 天 气 趋势 开始 图 片 名 称 (以 下 称 : 图 标 一 )， 
天 气 趋势 结束 图 片 名 称 (以 下 称 : 图 标 二 )， 现 在 的 天 气 实况 ， 天 气 和 生活 指数 。String(12) 到 
String(16): 第 二 天 的 气温 ， 概 况 ， 风 向 和 风力 ， 图 标 一 ， 图 标 二 。String(17) 到 String(21): 第 
三 天 的 气温 ， 概 况 ， 风 向 和 风力 ， 图 标 一 ， 图 标 二 。String(22): 被 查询 的 城市 或 地 区 的 介绍 。 


12.7 ”常见 问题 解答 


12.7.1 ASP.NET Web 服务 和 ASP.NET 网 站 的 区 别 


ASP.NET Web 服务 和 ASP.NET 网 站 的 区 别 。 
网 络 课堂 : http://bbs.itzen.com/thread-15798-1-1.html 


第 12 章 集成 第 三 方 Web 服务 


使 用 Visual Studio 创建 项 目 时 ， 有 ASP.NET Web 服务 和 ASPNET 网 站 这 两 种 类 型 。 请 问 
它们 两 个 有 什么 区 别 ? 
【解决 办 法 】 
其 实 很 容易 区 分 它们 。ASP.NET 网 站 就 是 基于 .NET 的 网 站 。 
ASP.NET Web 服务 可 以 创建 基于 .NET 的 服务 , 就 是 一 个 应 用 于 Web 的 应 用 程序 , 能 向 外 
界 暴露 一 个 API 接口 ， 然 后 可 以 通过 Web 来 调用 。 


12.7.2 ASP.NET Web 服务 应 用 程序 问题 


吨 4 ASPNET Web 服务 应 用 程序 问题 。 
骨 网 络 课堂 : http://bbs.itzcn.com/thread-15799-1-1.html 


我 在 ASPNET Web 服务 应 用 程序 中 有 一 个 类 和 方法 ， 代 码 如 下 所 示 : 


public class UserInfo 


{ 


public string email; 
public string name; 
public string state; 
public byte[] mybt; 


} 


[WebMethod] 
public void test(ref UserInfo [] u) 


. 


for: (int = 0; 主考 sength2 11++) 
{ 
u[i] .email = i.ToString(); 


} 


然后 在 窗 体 应 用 程序 中 调用 ， 代 码 如 下 所 示 : 


ServiceReferencel.UserIinfo[] cu = new 
WindowsFormsApplication]l.ServiceReferencel.UserInfo[6]; 
private void buttonl0 Click(object sender, EventArgs e) 


{ 


ServiceReferencel.ServicelSoapClient service = new ServiceReferencel. 


} 


ServicelSoapClient (); 
service.test (ref cu); 
for (int 1 = 0; i < cu.Length; i++) 
{ 

listBoxl.Items.Add (cu[i] .email); 
: 


结果 总 是 出 现 错误 : 


System.Web.Services.Protocols.SoapException: 服务 器 无 法 处 理 请 求 。 > 
System.NullReferenceException: 未 将 对 象 引用 设置 到 对 象 的 实例 。 

在 Webservicel.Servicel.test (UserInfo[]& u) 位 置 C:\Documents and Settings\ 
Administrator\My Documents\Visual Studio 2008\Projects\WebServicel\ 
WebServicel\Servicel.asmx.cs: 行 号 213 


--- 内 部 异常 堆栈 跟踪 的 结尾 --- 


< 


参数 如 果 不 是 数组 而 是 对 象 的 话 就 没有 问题 ， 这 是 什么 原因 啊 ? 
【解决 办 法 】 
我 想 应 该 是 以 下 原因 。 下 面 是 你 的 代码 : 


ServiceReferencel.UserInfo[] cu = new 
WindowsFormsApplication]l.ServiceReferencel.UserIinfo[6] 


在 这 里 cu 本 身 初始 化 了 ， 而 cu 里 面 每 个 元 素 却 都 是 null。 所 以 ，“public void test(ref 


UserInfo [] u)” 里 面 的 “u[i].email = iToString0” 是 有 问题 的 。 因 为 u[i] 都 是 null， 没 有 实例 化 。 
所 以 email 还 没有 呢 ， 怎 么 可 以 给 ufil.email 赋值 啊 。 


12.7.3 用 .NET 调用 Web 服务 时 报错 


用 .NET 调用 Web 服务 时 报错 。 
网 络 课堂 : http://bbs.itzcn.comy/thread-15800-1-1.html 


在 用 .NET 调用 Web 服务 时 ， 报 FaultException 错误 ， 提 示 “ 缺 少 head” 信 息 ， 该 怎么 解 


决 呀 ? 


【解决 办 法 】 
首先 应 该 看 看 WSDL 的 Header 是 什么 ， 一 般 是 类 似 下 面 的 内 容 : 


<soap:Header 
xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/o0asis-200401-wss-wssecur 
ity-secext-1.0.xsd"> 

<wsse:Security> 

<wsse:UsernameToken> 

<wsse:Username>username</wsse:Username> 

<wsse:Password Type="wsse:PasswordText">password </wsse:UsernameToken> 
</wsse:Security> 


如 果 使 用 的 是 Visual Studio 2008， 可 以 通过 Add Service 来 添加 Web 引用 ， 然 后 调用 时 指 


定 username 和 password: 


DocumentService.documentServiceClient client = new 

DocumentService .documentServiceClient() 7 
client.ChannelFactory.Credentials.UserName.UserName = "MyUserName"; 
client.CchannelFactory.Credentials.UserName.Password = "MyPass"; 


12.8 习 题 


一 、 填 空 题 
(1) 如 果 要 调用 第 三 方 Web 服务 提供 的 方法 生成 验证 码 ， 应 该 使 用 作为 返回 
数据 类 型 。 


m= >> 
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(2) 使 用 RadioButtonList 控件 时 ， 要 想 实现 该 控件 的 OnSelectedIndexChanged 事件 , 使 选 


定 内 容 更 改 时 自动 回 发 到 服务 器 上 ， 必 须 先 设 定 属性 ， 
二 、 选 择 题 
(1) 下 列 代码 中 ， 横 线 处 应 填写 . 


ValidateCodeWs .ValidateCodeWebService vcws = new 
ValidateCodeWS .ValidateCodeWebService () 7;// 实 例 化 web 服务 对 象 
protected void Page Load(object sender, EventArgs e) 
{ 

if (Request.Params["validateDate"] !=null) // 接 收 传 来 的 参数 


负 
int i=Int32.Parse( Request.Params ["validateDate"] .ToString()) 7 
Response.ContentType = "image/Png"; 
byte[] b = vcws.enValidateByte(i.Tostring()); 
} 
} 
A. Response.BinaryWrite(b): 
B. Response.WriteFile(b); 
C. Response.Write(b); 
D. Response.WriteSubstitution(b); 
(2) 对 下 段 代码 描述 正确 的 是 


ChinazZzipSearchWebServices.ChinaZzipSearchWebService Chinazip = 

new ChinaZipSearchWebServices.ChinaZipSearchWebService(); 
DataSet ds = ChinazZip.getAddressByZipCode (txtZip.Text.Trim(), ""); 
GridViewShowAddress.DataSource = ds.Tables[0] .DefaultView; 
GridViewShowAddress.DataBind(); 


A. 这 段 代码 不 正确 
B. 在 初始 化 时 可 以 不 用 添加 ChinaZipSearchWebServices Web 引用 名 
C. 我 们 可 以 将 代码 直接 写成 下 列 形式 
China2zipSearchWebServices .ChinaZipSearchWebService Chinazip = 
new ChinazipSearchWebServices.ChinazipSearchWebSsService(); 
DataSet ds = ChinaZip.getAddressByZipCode (txtZip.Text.Trim(), ""); 


GridViewShowAddress.DataSource = ds.Tables[0] .Columns; 
GridViewShowAddress.DataBind(); 


D. 我 们 可 以 将 代码 直接 写成 下 列 形式 


China2zipSearchWebServices .ChinaZipSearchWebService Chinazip = 
new ChinazipSearchWebServices.ChinazipSearchWebService(); 
GridViewShowAddress.DataSource = 
Chinazip.getAddressByZipCode (txtZzip.Text.Trim(), ""); 


GridViewShowAddress.DataBind(); 
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三 、 上 机 练习 


上 机 练习 1: 简 繁 体 转换 。 

使 用 第 三 方 Web 服务 ， 实 现 简单 的 简 繁 体 转 换 小 程序 。 简 繁体 转换 所 引用 的 Web 服务 的 
URL 地 址 为 “http://webservice.webxml.com.cn/WebServices/TraditionalSimplifiedWeb Service. 
asmx”。 实 现 效 果 如 图 12-14 所 示 。 


12-14 ”简体 转换 成 繁体 


上 机 练习 2: 国内 飞机 航班 时 刻 表 。 

使 用 第 三 方 Web 服务 ， 实 现 国内 飞机 航班 查询 ， 输 入 出 发 机 场 和 到 达 机 场 ， 即 可 查询 所 
有 航班 信息 。 第 三 方 Web 服务 的 URL 地 址 为 “http://webservice.webxml.com.cn/webservices/ 
DomesticAirline.asmx”， 实 现 效 果 如 图 12-15 所 示 。 


寅 nt 


12-15 ”国内 飞机 航班 查询 结果 


内 容 摘 要 : 


WCF 是 一 个 基于 SOA(Service Oriented Architecture， 面 向 服务 架构 ) 的 .NET 平台 下 的 统一 
框架 ， 它 代表 了 软件 架构 与 开发 的 一 种 发 展 方向 。 

使 用 WCF 开发 人 员 可 以 用 最 少 的 时 间 建 立 软件 与 外 界 通信 的 模型 。 它 整合 了 .NET 平台 下 
所 有 和 分 布 式 系统 有 关 的 技术 ， 像 Web Service、.NET Remoting、WSE 和 MSMQ 等 。 这 使 得 
开发 者 能 够 建立 一 个 跨 平台 的 、 安 全 的 、 可 依赖 的 、 事 务 性 的 解决 方案 ， 并 且 能 与 已 有 系统 兼 
容 协 作 。 

通过 本 章 的 学 习 ， 我 们 可 以 了 解 什么 是 WCF、WCEF 的 基本 术语 以 及 如 何 创 建 WCF 和 编 
写 客 户 端 代码 。 

学 习 目标 : 
了 解 WCF 的 作用 和 组 成 部 分 
掌握 创建 WCF 项 目的 方法 
掌握 如 何 生 成 WCF 服务 代理 类 
掌握 客户 端 调用 WCE 的 方法 
理解 WCF 中 地 址 、 绑 定 和 合约 的 作用 和 设置 方法 
掌握 如 何 通过 端点 来 配置 WCF 服务 
了 解 如 何 创建 WCF 主机 
熟 WCF 的 开发 流程 


13.1 什么 是 WCF 


WCF 是 Windows Communication Foundation(Windows 通信 基础 ) 的 简称 ， 由 .NET 
Framework 3.0 开始 引入 , 与 Windows Presentation Foundation 及 Windows Workflow Foundation 
共同 组 成 了 Windows 操作 系统 的 三 个 重大 应 用 程序 开发 类 库 。 


9 
,视频 教学 ， 光盘 /videos/13/ 什 么 是 WCF.avi 长度: 17 分钟 


13.1.1 ”基础 知识 一 一 WCF 概述 


WCF 是 一 个 面向 服务 编程 的 分 布 式 架 构 。 它 是 NET 框架 的 一 部 分 ， 因 为 WCF 并 不 能 脱 
离 .NET 框架 而 单独 存在 。 因 此 ， 虽 然 WCF 是 微软 为 应 对 SOA 解决 方案 的 开发 需求 专门 推出 
的 ， 但 它 并 不 是 像 Spring 和 Struts 那样 的 框架 ， 也 不 是 像 EJB 那样 的 容器 或 者 服务 器 。 

严格 地 说 ，WCF 就 是 专门 用 于 服务 定制 、 发 布 、 运 行 以 及 消息 传递 和 处 理 的 一 组 类 的 集 
合 ， 也 就 是 所 谓 的 “类 库 ”。 这 些 类 通过 一 定 方式 被 组 织 起 来 ， 共 同 协作 ， 并 为 开发 者 提供 统 
一 的 编程 模式 。WCF 之 所 以 特殊 ， 在 于 它 所 应 对 的 场景 与 普通 的 NET 类 库 不 同 ， 它 主要 用 于 
处 理 进 程 甚至 主机 之 间 消 息 的 传递 与 处 理 ， 同 时 它 引 入 了 SOAP 的 设计 思想 ， 以 服务 的 方式 公 
布 并 运行 ， 以 方便 客户 端 跨 进程 和 主机 对 服务 进行 调用 。 

实际 上 ，WCF 就 是 微软 对 分 布 式 编程 技术 的 最 大 集成 者 ， 它 将 DCOM、.NET Remoting、 
Enterprise Service、Web Service、WSE 以 及 MSMQ 集成 在 一 起 ， 从 而 降低 了 学 习 分 布 式 系统 
开发 的 难度 ， 并 统一 了 开发 标准 。 

也 就 是 说 , 在 WCF 框架 下 ,开发 基于 SOA 的 分 布 式 系统 变 得 容易 了 。 微 软 将 所 有 与 此 相 
关 的 技术 要 素 都 包含 在 内 ， 掌 握 了 WCF， 就 相当 于 掌握 了 敲 开 SOA 大 门 的 钥匙。 

例如 ， 下 面 通过 一 个 实例 说 明 WCF 的 优势 所 在 。 假 设 ， 我 们 要 为 一 家 婚车 租赁 公司 开发 
一 个 新 的 应 用 程序 ， 用 于 租车 预约 服务 。 该 租车 预约 服务 会 被 多 种 应 用 程序 访问 ， 包 括 呼 叫 中 
心 ， 基 于 J2EE 的 租车 预约 服务 以 及 合作 伙伴 的 应 用 程序 ， 如 图 13-1 所 示 。 


企业 内 部 局 域 网 本 叫 中 心 应 用 程序 


WCF 


NET Framework 平 台 
婚车 租赁 与 预约 应 用 程序 


婚车 预约 应 用 程序 


J2EE 平 台 


合作 伙伴 的 应 用 程序 


其 他 平台 


13-1 婚车 租赁 公司 应 用 程序 分 布 图 
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呼叫 中 心 运行 在 Windows 平台 下 ， 是 在 .NET Framework 下 开发 的 应 用 程序 ， 用 户 为 公司 
员工 。 由 于 该 婚车 租赁 公司 兼并 了 另外 一 家 租赁 公司 , 该 公司 原 有 的 婚车 预约 服务 应 用 程序 是 
J2EE 应 用 程序 ， 运 行 在 非 Windows 操作 系统 下 。 呼 叫 中 心 和 已 有 的 婚车 预约 应 用 程序 都 运行 
在 企业 内 部 局 域 网 环境 下 。 合 作 伙伴 的 应 用 程序 可 能 会 运行 在 各 种 平台 下 ， 这 些 合作 伙伴 包 
括 婚纱 拍摄 公司 、 司 仪 策划 公司 等 ， 他 们 会 通过 Intemet 来 访问 婚车 预约 服务 ， 实 现 对 婚车 的 
租用 。 

这 样 一 个 案例 是 一 个 典型 的 分 布 式 应 用 系统 。 如 果 没 有 WCF， 利 用 .NET 现 有 的 技术 应 该 
如 何 开发 呢 ? 

首先 考虑 呼叫 中 心 ， 它 和 我 们 要 开发 的 婚车 预约 服务 一 样 ， 都 是 基于 .NET Framework 的 
应 用 程序 。 呼 叫 中 心 对 于 系统 的 性 能 要 求 较 高 ， 在 这 样 的 前 提 下 ，.NET Remoting 是 最 佳 的 实 
现 技术 。 它 能 够 高 性 能 地 实现 NET 与 NET 之 间 的 通信 。 

要 实现 与 已 有 的 J2EE 婚车 预约 应 用 程序 之 间 的 通信 ， 只 有 基于 SOAP 的 Web Service 才 
可 以 ， 它 保证 了 跨 平台 的 通信 ; 而 合作 伙伴 由 于 是 通过 Internet 来 访问 ， 利 用 ASPNET Web 
Service， 也 是 较为 合理 的 选择 ， 它 保证 了 跨 网 络 的 通信 。 由 于 涉及 到 网 络 之 间 的 通信 ， 我 们 还 
要 充分 考虑 通信 的 安全 性 ， 利 用 WSE(Web Service Enhancements) 可 以 为 Web Service 提供 安全 
的 保证 。 

一 个 好 的 系统 除了 要 保证 访问 和 管理 的 安全 和 高 性 能 外 ， 同 时 还 要 保证 系统 的 可 依赖 性 。 
因此 ,事务 处 理 是 企业 应 用 必须 考虑 的 因素 , 对 于 婚车 预约 服务 同样 如 此 。 在 .NET 中 , Enterprise 
Service(COM+) 提 供 了 对 事务 的 支持 ， 其 中 还 包括 分 布 式 事务 (Distributed Transactions)。 不 过 对 
于 Enterprise Service 而 言 ， 它 仅 支持 有 限 的 几 种 通信 协议 。 

如 果 还 要 考虑 异步 调用 、 脱 机 连接 、 断 点 连接 等 功能 ， 我 们 还 需要 应 用 MSMQ(Microsoft 
Message Queuing) 利 用 消息 队列 支持 应 用 程序 之 间 的 消息 传递 。 

如 此 看 来 ， 要 建立 一 个 好 的 婚车 租赁 预约 服务 系统 ， 需 要 用 到 的 .NET 分 布 式 技术 包 
括 : .NET Remoting、Web Service、COM+ 等 5 种 技术 ， 这 既 不 利于 开发 者 的 开发 ， 也 加 大 了 
程序 的 维护 难度 和 开发 成 本 。 正 是 基于 这 样 的 缺陷 ，WCF 才 会 在 NET 3.0 中 作为 全 新 的 分 布 
式 开发 技术 被 微软 强势 推出 ， 它 整合 了 上 述 介绍 的 分 布 式 技术 ， 成 为 理想 的 分 布 式 开发 解决 方 
案 。 如 表 13-1 所 示 列 出 了 WCEF 与 之 前 相关 技术 的 比较 。 


表 13-1 WCF 与 现 有 技术 比较 


.NET Enterprise 


特 性 | WCF 
Service Remoting Services 
具有 互 操作 性 的 Web 服务 | 支持 | 支持 
支持 NET 之 间 的 通信 | 支持 | 支持 
分 布 式 事务 | | 支持 
支持 WS 标准 | | 支持 
消息 队列 支持 


从 表 13-1 中 来 看 ,WCEF 完全 可 以 看 做 是 Web Service、 .NET Remoting、Enterprise Service、 
WSE、MSMQ 等 技术 的 并 集 。 因 此 ， 对 于 上 述 婚 车 预约 服务 系统 的 例子 ， 利 用 WCF， 就 可 以 
解决 包括 安全 、 可 依赖 、 互 操作 、 跨 平台 通信 等 需求 。 开发 者 再 不 用 去 分 别 了 解 .NET Remoting 


< 


和 WSE 等 各 种 技术 了 。 
人 @} 事实 上 WCF 远 非 简单 的 并 集 这 样 简单 , 它 是 真正 面向 服务 的 产品 , 它 已 经 改变 了 
注音 | 。 通常 的 开发 模式 。 


13.1.2 ”基础 知识 一 一 WCF 组 成 部 分 


软件 设计 的 一 个 重要 原则 : 软件 组 件 必 须 针对 特定 的 任务 专门 设计 和 优化 。 假 如 我 们 要 做 
一 个 管理 软件 ， 想 象 一 下 ， 如 果 一 个 软件 非常 依赖 于 与 外 界 通信 ， 那 么 我 们 不 能 把 管理 软件 与 
外 界 通信 的 逻辑 考虑 在 管理 系统 内 部 。 所 以 ， 必 须 把 通信 任务 委托 给 不 同 的 组 件 。 用 WCF 术 
语 来 说 ， 这 个 组 件 称 为 WCF 服务 。 更 通俗 地 讲 ，WFC 服务 就 是 负责 与 外 界 通 信 的 软件 。 

一 个 WCF 服务 由 下 面 三 部 分 组 成 。 

@@ ”Service Class: 一 个 标记 了 ServiceContract 属性 的 类 ， 其 中 可 以 包含 多 个 方法 。 该 类 

除了 标记 一 些 WCEF 特有 的 属性 外 ， 与 一 般 的 类 没有 区 别 。 

@ ”Host: 可 以 是 应 用 程序 、 进 程 或 者 Windows 服务 等 ， 它 是 WCF 服务 的 运行 环境 。 

@ ”Endpoints: 可 以 是 一 个 ， 也 可 以 是 一 组 ， 它 是 WCF 实现 通信 的 核心 要 素 。 

如 图 13-2 显示 了 这 三 部 分 在 WCF 服务 中 的 位 置 。 

一 个 WCF 服务 必须 能 为 不 同 的 通信 场景 提供 不 同 的 访问 点 ， 这 些 访问 点 称 为 WCF 端点 ， 
也 就 是 上 面 所 提 到 的 EndPoint。 每 个 端点 都 有 一 个 绑 定 (Binding)、 一 个 地 址 (Address) 和 一 个 合 
约 (Contract)， 如 图 13-3 所 示 。 


Process 


Application Domain 


Address 
图 13-2 WCF 组 成 部 分 图 13-3 ”端点 组 成 部 分 
@ ” 绑 定 : 指定 该 端点 如 何 与 外 界 通信 ， 也 就 是 为 端点 指定 通信 协议 ， 包 括 传输 协议 、 编 


码 协议 和 安全 协议 。 
@ 地 址 : 一 个 端点 地 址 ， 如 果 通 过 端点 与 WCF 通信 ， 必 须 把 通信 指定 到 网 络 地 址 。 
@ 合约 : 一 个 端点 上 合约 指定 通过 该 端点 的 用 户 能 访问 到 WCEF 服务 的 什么 操作 。 
您 = 》 为 了 便于 记忆 EndPoint 的 这 三 个 部 分 ， 可 以 将 Address、Binding 和 Contract 简称 
过 为 “ABC”. 
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13.2 创建 第 一 个 WCF 服务 程序 


通过 上 节 的 学 习 ， 相 信 大 家 对 WCF 的 概念 、 作 用 及 其 组 成 部 分 都 有 了 一 个 大 致 的 了 解 。 
本 节 打 算 在 详细 介绍 WCF 之 前 看 一 个 简单 的 WCF 实例 , 通过 本 实例 我 们 将 了 解 WCF 程序 的 
开发 步骤 和 运行 流程 ， 为 后 面 核心 概念 的 理解 黄 定 基础 。 


. 
加 ,视频 教学 ， 光盘 /videos/13/ 第 一 个 WCF 程序 .avi 加 长 度 : 16 分 钟 


13.2.1 实例 描述 


由 于 WCF 是 在 NET Framework 3.0 之 后 开始 出 现 的 ， 所 以 在 开发 之 前 首先 要 选择 一 款 支 
持 它 的 开发 工具 。 这 里 我 们 以 Visual Studio 2010 为 例 进 行 介绍 。 

在 Visual Studio 2010 中 创建 WCF 服务 的 过 程 非常 简单 ， 我 们 不 需要 做 任何 配置 ， 只 需 : 
根据 需求 编写 相应 的 业务 逻辑 代码 即 可 。 


13.2.2 ”实例 应 用 


【 例 13-1】 创建 第 一 个 WCEF 服务 程序 

(1) 在 Visual Studio 2010 中 打开 【新 建 项 目 】 对 话 框 ， 选 择 模板 为 WCF， 再 选择 【WCF 
服务 库 】 项 ， 然 后 设置 项 目 名 称 为 “FirstWcefServiceLibrary”， 单 击 【 确 定 】 按 钮 完成 创建 ， 
如 图 13-4 所 示 。 


新建 项 目 
是 的 异 板 


:sa CF 
一 cr 服务 类 记 项 上 (1) 


前 岂 方 训 名 称 国 | Phrs'eEierrceLihrary 


13-4 创建 WCF 项 目 


(2) WCEF 项 目 创建 完成 之 后 ， 在 【解决 方案 资源 管理 器 】 窗 口中 将 看 到 默认 生成 的 项 目 
结构 及 IServicel.cs 文件 的 内 容 ， 如 图 13-5 所 示 。 


< 人 mm 


realabeary 


合用 “ 重 阅 ” 麻 音 上航 “重生 本 ” 合 字 ， 可 以 同时 下 避 代 友和 本 时 文件 航 按 


在 天 1 让 的 旅人 综 作 


更 朋 的 玫 邱 志 定 尼 复 全 类 并 入 加 到 事务 注 作 


13-5 WCF 项目 内 容 


在 这 里 的 IServicel.cs 称 为 合约 ，WCF 的 合约 必须 要 以 接口 的 方式 定义 。Servicel.cs 为 服 
务 的 实现 ， 即 它 继承 接口 并 进行 实现 。App.config 是 WCF 服务 的 配置 信息 。 

(3) 在 IServicel.cs 文件 中 的 “[ServiceContract]” 为 服务 合约 ，“[OperationContract]” 声 
明 该 方法 可 以 在 WCF 中 调用 。 按 照 这 种 规则 ， 手 动 创建 一 个 方法 ， 代 码 如 下 : 

// 手 动 创建 的 方法 

[OperationContract] 

string Welcome (string str); 

(4) 打开 Servicel.cs 文件 ， 添 加 服务 合约 中 声明 的 Welcome0) 方 法 的 实现 代码 。 上 有 具体 代码 
如 下 所 示 : 

// 实 现在 服务 合约 中 定义 声明 的 Welcome () 方 法 


public string Welcome (string str) 
{ 
return string.Format ("你 好 {0}， 欢 迎 来 到 WcF 的 世界 。 当 前 时 间 是 : {1}。"，str, 


DateTime.Now.ToString()); 
} 


(5) 至 此 ， 关 于 WCEF 服务 合约 的 创建 及 实现 就 都 定义 好 了 。 下 面 对 WCF 服务 的 配置 信 
息 进行 定义 ， 指 定 客户 端 通过 什么 方式 引用 WCF 服务 。 打 开 App.config 文件 ， 其 中 的 内 容 如 
下 所 示 : 


<?xml version="1.0" encoding="utf-8" ?> 


<configuration> 

<system.web> 
<compilation debug="true" /> 

</system.web> 

<!-- 部 署 服务 库 项 目 时 ， 必 须 将 配置 文件 的 内 容 添加 到 主机 的 app .config 文件 中 。 
System.Configuration 不 支持 库 的 配置 文件 。--> 

<system.serviceModel> 
<services> 


<service name="FirstWcfServiceLibrary.Servicel"> 


m= > 
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<host> 
<baseAddresses> 
<add baseAddress = "http://localhost:8732/Design Time Addresses/ 
FirstWcfServiceLibrary/Servicel/" /> 
</baseAddresses> 
</host> 
<!-- Service Endpoints 一 -> 
<!-- 除非 完全 限定 ， 否 则 地 址 将 与 上 面 提供 的 基 址 相关 --> 
<endpoint address ="" binding="wsHttpBinding™" 
contract="FirstWcfServiceLibrary.IServicel"> 


了 
部 署 时 ， 应 删除 或 替换 下 列 标识 元 素 ， 以 反映 用 来 运行 所 部 署 服务 的 标识 。 
删除 之 后 ，WcF 将 自动 推断 相应 标识 。 
--> 
<identity> 
<dns value="localhost"/> 
</identity> 
</endpoint> 
<!-—- Metadata Endpoints 一 -> 


<!-- 元 数据 交换 终 节点 供 相应 的 服务 用 于 向 客户 端 做 自我 介绍 。 --> 
<!-- 此 终 节点 不 使 用 安全 绑 定 ， 应 在 部 署 前 确保 其 安全 或 将 其 删除 --> 
<endpoint address="mex" binding="mexHttpBinding" 
contract="IMetadataExchange"/> 
</service> 
</services> 
<behaviors> 
<serviceBehaviors> 
<behavior> 
<!-- 为 避免 泄漏 元 数据 信息 ， 
请 在 部 署 前 将 以 下 值 设 置 为 false 并 删除 上 面 的 元 数据 终 节点 。--> 
<serviceMetadata httpGetEnabled="True"/> 
<!-- 要 接收 故障 异常 详细 信息 以 进行 调试 ， 请 将 以 下 值 设 置 为 true。 
在 部 署 前 设置 为 fal se 以 避免 泄漏 异常 信息 --> 
<serviceDebug includeExceptionDetailInFaults="False" /> 
</behavior> 
</serviceBehaviors> 
</behaviors> 
</system.serviceModel> 
</configuration> 


(6) 在 这 个 文件 中 需要 修改 的 是 baseAddresses 节点 下 add 子 节点 的 baseAddress 属性 ， 该 
属性 为 一 个 URL 用 于 指定 WCF 的 引用 地 址 。 如 下 所 示 为 本 实例 中 修改 后 的 代码 : 
<baseAddresses> 
<add baseAddress = 


"http://localhost:8732/FirstWcfServiceLibrary/Servicel/" /> 
</baseAddresses> 


< 


(7) 下 面 创建 一 个 控制 台 应 用 程序 ， 通 过 代码 的 形式 启动 一 个 WCF 服务 主机 。 该 控制 台 
应 用 程序 与 WCF 项 目 在 同一 个 解决 方案 中 ， 并 引用 了 WCF 项 目 ， 名 称 为 “testWCFConsole 
Application”。 

(8) 在 控制 台中 添加 如 下 命名 空间 的 引用 : 


using System.ServiceModel; 


using FirstWcfServiceLibrary; 


0 System.ServiceModel 命名 空间 是 WCF 服务 必需 的 , 如 果 不 引 用 将 无 法 调用 WCF。 


(9) 对 控制 台中 的 Main0 方 法 进行 修改 ， 最 终 代码 如 下 所 示 : 


static void Main(string[] args) 
{ 
// 指 定 主机 使 用 WcF 服务 的 DRL 
Uri wcfUri=new Uri("http://localhost:8732/FirstWcfService"); 
// 针 对 WcF 服务 创建 一 个 主机 
ServiceHost host = new ServiceHost (typeof (Servicel), wcfUri); 
// 打 开 主 机 
host.Open() 7 
// 输 出 提示 信息 
Console.WriteLine ("WCF 服务 已 经 在 主机 启动 。") ; 
console.WriteLine (" 按 任意 键 结束 服务 !") ; 
Console.Read(); 


// 关 闭 主机 


host.Close(); 
} 

(10) 下 面 创建 一 个 控制 台 应 用 程序 作为 WCF 客户 端 ， 它 也 与 WCF 项 目 在 同一 个 解决 方 
案 中 ， 名 称 为 “WCFServiceClient”。 

(11) 大 家 还 记得 调用 Web 服务 时 的 代理 类 吧 ( 使 用 wsdl 命令 生成 的 .cs 文件 )。 同 样 ， 在 调 

用 WCEF 服务 之 前 我 们 也 要 生成 一 个 代理 类 。 

从 Visual Studio 2010 的 开始 菜单 项 中 选择 【命令 提示 】 工 具 进 入 命令 行 。 然 后 转 到 客户 端 

要 存放 代理 类 的 目录 ， 在 本 实例 中 为 “D:\WCF”。 

(12) 运行 sveutil 命令 生成 代理 类 。 此 时 需要 指定 生成 时 的 语言 、 类 名 、 配置 文件 以 及 WCF 

服务 的 URL 地址 ， 执 行 成 功 之 后 将 生成 两 个 文件 ， 如 图 13-6 所 示 。 


图 13-6 使 用 svcutil 生成 WCF 代理 类 
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(13) 在 WCFServiceClient 项 目 中 使 用 添加 现 有 项 功能 ， 将 上 步 生 成 的 两 个 文件 添加 到 项 
目 中 。 

(14) 添加 对 “System.ServiceModel” 和 “System.Runtime.Serialization ”程序 集 的 引用 。 

(15) 将 代理 类 生成 的 命名 空间 “FirstWcefServiceLibrary” 添 加 到 项 目 中 。 


using FirstWcfServiceLibrary; 


(16) 在 Main0 方 法 中 编写 客户 端 代码 ， 最 终 代码 如 下 所 示 : 


static void Main(string[] args) 


// 实 例 化 wcF 中 的 类 

ServicelClient client = new ServicelClient(); 

// 输 出 提示 信息 

| 欢迎 使 用 WcE 客户 端 应 用 程序 


Console.WriteLine(); 
Console.Write ("请 输入 名 字 : "); 
string username = Console.ReadLine(); 
// 调 用 Welecome () 方 法 
string result = client.Welcome (username); 
Console.WriteLine(); 
Console.WriteLine ("WCF 服务 器 端 返回 的 结果 为 : ") ; 
// 输 出 结果 
Console.WriteLine (result); 
Console.WriteLine(); 
Console.WriteLine(" 按 任意 键 退出 程序 !") ; 
Console.ReadKey (); 

} 


(17) 至 此 ， 完 成 了 第 一 个 WCF 服务 的 编写 、 测 试 与 调用 。 整 个 解决 方案 中 包含 了 一 个 
WCF 项 目 和 两 个 控制 台 项 目 。 


13.2.3 ”运行 结果 


现在 ,我 们 开始 运行 上 面 创建 的 程序 。 首 先是 运行 WCF 项 目 ， 在 FirstWcfServiceLibrary 
中 按 FS 键 执行 。 

此 时 ，Visual Studio 2010 检测 到 当前 要 运行 的 WCF 项 目 ， 它 会 打开 【WCF 测试 客户 端 】 
工具 。 在 这 里 可 以 浏览 WCF 服务 的 地 址 、 提 供 的 方法 、 配 置 文件 ， 而 且 还 可 以 对 方法 进行 测 
试 。 如 图 13-7 所 示 为 测试 Welcome0 方 法 时 的 窗口 。 


[EEC 


13-7 ”使 用 【WCF 测试 客户 端 】 测 试 Welcome() 方 法 


< 


与 Web 服务 类 似 ，WCEF 服务 也 可 以 在 浏览 器 中 浏览 。 例 如 ， 在 本 实例 中 可 以 通过 地 址 
“http:Wlocalhost:8732/FirstWcfServiceLibrary/Servicel/” 来 浏览 WCF 服务 ， 如 图 13-8 所 示 。 


:TA 


有 和 ,天 要 放下 记 吉 并 3 贡 且 于 再 扳 各。 可 以 全 用友， 只 扩 行 中 本 evevil exe 工 到 天下 闪 作 


13-8 ”使 用 浏览 器 查看 WCF 服务 


如 果 输 入 地 址 “http://localhost:8732/FirstWcfServiceLibrary/Servicel/?WSDL” 将 可 以 看 到 
WCF 服务 的 WSDL 内 容 ， 如 图 13-9 所 示 。 


图 13-9 查看 WCF 服务 的 WSDL 


现在 切换 到 testWCFConsoleApplication 项 目 并 运行 。 该 项 目的 作用 是 创建 一 个 主机 并 在 指 
定 的 URL 中 开启 WCF 服务 ， 运 行 后 的 输出 如 图 13-10 所 示 。 

在 程序 中 我 们 指定 从 URL“http:Wlocalhost:8732/FirstWecfService ”启动 WCF 服务 ， 运 行 后 
可 以 在 浏览 器 中 输入 该 URL 验证 是 否 成 功 ， 如 图 13-11 所 示 。 


= re Foundeiion 服务 
全 和 用 具 村 各 取 更 大- 


图 13-10 启动 WCF 服务 图 13-11 验证 WCF 服务 
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全 


转 到 WCFServiceClient 项 目 中 ， 启 动 它 来 验证 生成 的 代理 类 是 否 有 效 。 如 果 有 效 将 会 看 到 
类 似 图 13-12 所 示 的 输出 结果 。 


图 13-12 使 用 代理 类 测试 WCF 服务 


13.2.4 ”实例 分 析 


> 


本 实例 主要 讲解 了 WCEF 服务 的 开发 和 使 用 过 程 ， 而 未 对 涉及 的 术语 展开 介绍 。 

为 了 演示 这 个 过 程 ， 在 本 实例 中 创建 了 3 个 项 目 并 分 别 运行 进行 测试 。 第 1 个 为 WCF 服 
务 项 目 ，Visual Studio 2010 为 它 提供 了 单独 的 测试 工具 。 当 然 也 可 以 通过 浏览 器 来 验证 。 第 2 
个 项 目 基 于 WCF 服务 项 目 来 创建 一 个 主机 ， 它 可 以 向 外 界 提供 WCEF 服务 。 第 3 个 项 目 则 是 
一 个 客户 端 ， 它 通过 代理 类 与 WCF 服务 进行 通信 。 对 于 第 3 个 项 目 也 可 以 通过 添加 服务 引用 
的 方式 来 使 用 ， 有 兴趣 的 读者 可 以 试 试 。 

最 后 要 注意 ， 应 该 先 定义 一 个 接口 ， 再 实现 接口 ， 然 后 配置 位 置信 息 ， 接 下 来 才 是 调用 。 


13.3 WCF 核心 概念 详解 


如 果 仅 仅 是 希望 能 够 在 项 目 中 应 用 WCF， 那么 对 于 读者 而 言 ， 只 要 掌握 了 WCEF 的 基础 知 
识 ， 那 么 对 于 一 般 的 应 用 就 足够 了 。 要 做 到 这 一 点 就 很 容易 了 ， 微 软 秉承 了 一 贯 的 方式 ， 将 
WCF 这 门 技术 优雅 地 呈现 给 开发 者 ， 封 装 了 复杂 的 实现 逻辑 ， 提 供 了 易于 调用 的 类 库 和 相关 
的 工具 ， 使 得 开发 者 能 够 快速 地 完成 WCF 程序 的 开发 。 

但 是 ， 如 果 我 们 要 应 用 WCF 实现 一 整套 解决 方案 ， 就 需要 深度 挖掘 WCF 的 内 部 实现 ， 
掌握 许多 WCEF 的 高 级 应 用 , 并 了 解 如 何 合理 、 有 效 地 应 用 WCF, 并 根据 项 目 实际 情况 对 WCF 
进行 扩展 。 

在 这 一 节 ， 我 们 将 对 前 面 出 现 的 WCF 核心 概念 进行 详细 介绍 ， 像 WCF 地 址 、 绑 定 和 合 
约 等 。 


A 
6 视频 教学 : 光盘 /videos/13/ WCF 概念 详解 .avi 图 长 度 : 27 分钟 


13.3.1 基础 知识 一 一 地 址 


WCF 的 每 一 个 服务 都 具有 一 个 唯一 的 地 址 (Address)。 每 个 地 址 都 包含 两 个 重要 元 素 : 服 


务 位 置 与 传输 协议 ， 或 者 是 用 于 服务 通信 的 传输 方式 。 服 务 位 置 包括 目标 主机 名 、 站 点 (或 者 
网 络 )、 通 信 端 口 、 管 道 (或 者 队列 )， 以 及 一 个 可 选 的 特定 路 径 或 者 URI。 


总 的 来 说 ，WCEF 支持 如 下 的 几 种 传输 方式 : 
© HITP 

© TCP 

@ Peer Network( 对 等 网 ) 

@ IPC( 基 于 命名 管道 的 内 部 进程 通信 ) 

® MSMQ 

地 址 通常 采用 如 下 格式 : 

[传输 协议 ] : // [主机 名 或 域名 ] [ :可 选 端口 ] 
例如 ， 如 下 所 示 的 这 些 都 是 正确 的 地 址 : 


http://localhost:8080 
http://localhost:5678/MyWcfService 
net.tcp://localhost:1010/MyWcfService 
net .pipe://localhost/MyWcfPipe 
net.msmq://localhost/public/MyWcfService 
net.msmq://localhost/MyWcfService 


如 上 述 的 示例 所 示 , 可 以 将 地 址 “http://localhost:8080 ”理解 为 * 采 用 HTTP 协 议 访 问 localhost 


主机 ， 并 在 8080 端口 等 待 用 户 的 调用 ”。 对 于 “http://localhost:5678/MyWcfService” 地 址 则 可 


以 理解 为 “采用 HTTP 协议 访问 localhost 主机 ，MyWefService 服务 在 5678 端口 处 等 待 用 户 的 


调用 。” 


1. TCP 地 址 

TCP 地 址 采用 nettcp 作为 协议 进行 传输 ， 通 常 它 还 带 有 端口 号 。 例 如 : 
net.tcp://localhost:8018/MyWcfService 

如 果 没 有 指定 端口 号 ， 则 TCP 地 址 的 默认 端口 号 为 808。 例 如 : 
net.tcp://localhost/MyWcfService 

另外 ， 两 个 TCP 地 址 (来 自 于 相同 的 主机 ) 可 以 共享 一 个 端口 。 例 如 : 


net.tcp://localhost:8018/MyWcfService 
net.tcp://localhost:8018/MyOtherWcfService 


2. HTTP 地 址 
HTTP 地 址 是 使 用 频率 最 高 的 一 种 地 址 ， 它 使 用 HTTP 协议 进行 传输 ， 也 可 以 利用 HTTPS 


进行 安全 传输 。HTTP 地 址 通常 会 被 用 作对 外 的 基于 Internet 的 服务 ， 并 为 其 指定 端口 号 。 
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例如 : 


http://localhost:8088 
http://localhost:8088/MyWcfService 
https://localhost/MyWcfService 


如 果 没 有 指定 端口 号 ， 则 默认 为 80。 与 TCP 地 址 相似 ， 两 个 相同 主机 的 HTTP 地 址 可 以 
共享 一 个 端口 ， 甚 至 相同 的 计算 机 。 

3. IPC 地 址 

IPC 地 址 使 用 net.pipe 协议 进行 传输 ， 这 意味 着 它 将 使 用 Windows 的 命名 管道 机 制 。 在 
WCF 中 ， 使 用 命名 管道 的 服务 只 能 接收 来 自 同 一 台 计算 机 的 调用 。 


因此 ， 在 使 用 时 必须 明确 指定 本 地 计算 机 名 或 者 直接 命名 为 localhost， 然 后 再 为 管道 名 提 
供 一 个 唯一 的 标识 字符 串 。 例 如 : 


net.pipe://localhost/MyWcfPipe 
net .pipe://zhht/MyWcfPipe 


@ | 每 台 计算 机 只 能 打开 一 个 命名 管道 。 因此， 两 个 命名 管道 地 址 在 同一 台 计 算 机 上 
注意 | 不 能 共享 一 个 管道 名 。 
4. MSMQ 地 址 


MSMQ 地址 使 用 net.msmq 协议 进行 传输 ,即使 用 了 微软 消息 队列 (Microsoft Message Queue) 
机 制 。 在 使 用 时 必须 为 MSMQ 地 址 指定 队列 名 。 如 果 是 处 理 私 有 队列 ， 则 必须 指定 队列 类 型 。 
例如 : 


net.msmq://localhost/private/MyWcfService 
net.msmq://localhost/private/MyOtherWcfService 


但 对 于 公有 队列 而 言 ， 队 列 类 型 可 以 省 略 。 例 如 : 


net.msmq://localhost/MyWcfService 
net.msmq://zhht/private/MyWcfService 


5.， 对 等 网 地 址 


对 等 网 地 址 (Peer Network Address) 使 用 netp2p 协议 进行 传输 ， 它 使 用 了 Windows 的 对 等 
网 传输 机 制 。 如 果 没 有 使 用 解析 器 ， 我 们 就 必须 为 对 等 网 地 址 指定 对 等 网 名 称 、 唯 一 的 路 径 以 
及 端口 。 


国 由 于 对 等 网 的 使 用 与 配置 起 出 了 本 书 范围 .因此 在 这 里 就 不 再 介绍 ， 有 兴趣 的 读 
各 元 | 。 者 可 以 参考 相关 书籍 。 


13.3.2 ”基础 知识 一 一 绑 定 


WCF 中 的 绑 定 (Binding) 指 定 了 服务 的 通信 方式 。 
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使 用 绑 定 也 是 WCF 开发 区 别 于 Web 服务 开发 的 一 个 重要 方面 。 因 为 WCF 带 有 许多 可 供 
选择 的 绑 定 ， 每 种 绑 定 都 适合 于 特定 的 需求 。 另 外 ， 如 果 现 有 的 绑 定 类 型 不 能 满足 需求 ， 还 可 
以 通过 扩展 CustomBinding 类 型 创建 绑 定 。 

简单 来 说 ，WCF 绑 定 可 以 指定 如 下 特性 : 


@ 传输 协议 
@ 安全 要 求 
@ 编码 格式 
@ 事务 处 理 要 求 


一 个 绑 定 类 型 包含 多 个 绑 定 元 素 ， 它 们 描述 了 上 面 所 有 的 绑 定 要 求 。WCEF 内 置 了 10 种 类 
型 的 绑 定 ， 表 13-2 中 列 出 这 些 及 其 说 明 。 


表 13-2 WCF 绑 定 类 型 


绑 定 类 型 说 明 
BasicHttpBinding 在 Web 服务 的 交互 操作 中 使 用 最 广泛 ， 可 使 用 HTTP 协议 
BasicHttpBinding 
或 者 HTTPS 协议 进行 传输 ， 其 安全 性 取决 于 协议 安全 
WSHttpBinding 是 对 BasicHttpBinding 的 增强 ， 它 使 用 扩展 的 SOAP 确保 安 
WSHttpBinding 全 性 、 可 靠 性 和 事务 处 理 。 同 样 使 用 HTTP 协议 或 者 HTTPS 协议 进行 传输 ， 
但 是 为 了 确保 安全 ， 使 用 了 WS-Security 
WSFederationHttpBinding 是 一 种 安全 、 可 交互 操作 的 绑 定 ， 它 支持 在 多 个 系 
WSFederationHttpBinding 
统 上 共享 身份 ， 以 进行 身份 验证 和 授权 
WSDualHttpBinding 与 WSHttpBinding 相反 ， 这 种 类 型 支持 消息 的 双向 传输 
NetTcpBinding 使 用 TCP/IP 协议 为 通信 提供 绑 定 
NetPeerTcpBinding 使 用 对 等 网 协议 为 通信 提供 绑 定 
使 用 命名 管道 协议 为 通信 提供 绑 定 ， 该 类 型 为 在 同一 系统 的 不 同 进程 之 间 的 
NetNamedPipeBinding a 
通信 进行 了 优化 
该 类 型 的 绑 定 会 将 消息 发 送 到 消息 队列 中 ， 它 要 求 WCF 应 用 程序 位 于 客户 
NetMsmqBinding 
端 和 服务 器 上 
MsmqIntegrationBinding 该 类 型 的 绑 定 将 会 使 用 消息 队列 的 已 有 应 用 程序 
CustomBinding 这 种 类 型 是 自 定 义 的 绑 定 类 型 


@ | 所 有 以 Net 前 组 开始 的 绑 定 类 型 都 使 用 二 进 制 编码 在 .NET 应 用 程序 之 间 通 信 ， 这 
提示 | 种 编码 格式 比 文 本 格式 要 快 。 
在 表 13-2 中 列 出 的 每 种 绑 定 类 型 都 有 自己 的 特性 。 例 如 ， 以 WS 为 前 缀 的 绑 定 类 型 是 独 
立 于 平台 的 ， 支 持 Web 服务 规范 。 以 Net 为 前 组 的 是 使 用 二 进 制 格式 ， 使 NET 应 用 程序 之 间 
的 通信 具有 更 高 的 性 能 。 如 表 13-3 中 针对 这 些 绑 定 类 型 按 特 性 进行 了 分 类 。 
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表 13-3 ” 绑 定 类 型 支持 的 特性 


特 性 支持 的 绑 定 类 型 
WSHttpBinding 、 WSDualHttpBinding 、 WSFederationHttpBinding 、 NetTcpBinding 、 


NetNamedPipeBindin 


可 靠 的 会 话 WSHttpBinding、WSDualHttpBinding、WSFederationHttpBinding、NetTcpBinding 
WSHttpBinding 、 WSDualHttpBinding 、 WSFederationHttpBinding 、 NetTcpBinding 、 


NetNamedPipeBinding 、NetMsmqBinding、MsmqIntegrationBinding 


双向 通信 WSDualHttpBinding 、NetTcpBinding、NetNamedPipeBinding、NetPeerTcpBinding 


除了 定义 绑 定之 外 ，WCF 服务 还 必须 定义 端点 。 端 点 依赖 于 合约 、 服 务 的 地 址 和 绑 定 。 
例如 ， 在 下 面 的 示例 代码 中 ， 实 例 了 一 个 ServiceHost 对 象 ， 将 地 址 “http://localhost:8080/My 
WefService” 和 一 个 WSHttpBinding 实例 绑 定 到 服务 的 一 个 端点 上 。 


static void StartService() 

{ 
ServiceHost host; 
Uri baseAddress = new Uri("http://localhost:8080/MyWcfService"); 
host = new ServiceHost (typeof (Servicel)); 
WSHttpBinding binding = new WSHttpBinding(); 
host.AddServiceEndpoint (typeof (Servicel), binding, baseAddress); 
host.Open(); 

} 


除了 以 编程 方式 定义 绑 定 之 外 ， 还 可 以 在 应 用 程序 的 配置 文件 中 定义 它 。WCEF 的 所 有 配 
置 都 位 于 <system.serviceModel> 节 点 中 ,<service> 节 点 定义 了 WCF 中 所 提供 的 服务 , <bindings> 
节点 定义 了 绑 定 信息 。 

例如 ， 下 面 的 配置 文件 同样 实现 了 上 述 代码 的 功能 : 


<?xml Version="1.0"” encoding="utf-8" ?> 
<configuration> 
<system.serviceModel> 
<services> 
<service name="FirstWcfServiceLibrary.Servicel"> 
<host> 
<baseAddresses> 
<add baseAddress = "http://localhost:8080/MyWcfService" /> 
</baseAddresses> 
</host> 
<endpoint address ="" binding="wsHttpBinding" contract=" 
FirstWcfServiceLibrary.IServicel"bindingConfiguration="configl"/> 
</service> 
</services> 
<bindings> 
<wsHttpBinding> 
<binding name="configl"> 
<reliableSession enabled="true"/> 
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</binding> 
</wsHttpBinding> 
</bindings> 
</system.serviceModel> 

</configuration> 

可 以 看 到 ， 一 个 WCF 服务 必须 要 有 一 个 端点 ， 该 端点 包含 地 址 、 绑 定 和 合约 信息 。 
WSHttpBinding 的 默认 配置 由 bindingConfiguration 属性 指定 , 该 属性 引用 了 下 方 名 为 “config1” 
的 绑 定 配置 信息 。 该 配置 信息 位 于 <bindings> 节 点 中 ， 并 启用 了 reliableSession 。 


13.3.3 ”基础 知识 一 一 合约 


任何 一 个 分 布 式 应 用 程序 , 它 之 所 以 能 够 互相 传递 消息 , 都 是 事先 制定 好 了 数据 交换 规则 ， 
这 个 规则 正 是 交换 数据 的 双方 (比如 服务 器 端 和 客户 端 ) 能 彼此 理解 对 方 的 依据 。 WCF 作为 分 布 
式 开发 技术 的 一 种 ， 同 样 具 有 这 样 一 种 特性 。 而 在 WCF 中 制定 的 规则 就 被 称 之 为 合约 
(Contract)， 它 是 WCF 的 消息 标准 ， 是 任何 一 个 WCF 程序 都 不 可 或 缺 的 一 部 分 。 

在 WCF 中 合约 分 为 4 种 ， 分 别 为 : 定义 服务 操作 的 服务 合约 (Service Contract)、 定 义 自 定 
义 数 据 结 构 的 数据 合约 (Data Contract)、 定 义 错误 异常 的 异常 合约 (Fault Contract)， 以 及 直接 控 
制 消息 格式 的 消息 合约 (Message Contract)。 


1. 服务 合约 


一 般 情况 下 , 我 们 用 接口 (Interface) 来 定义 服务 合约 。 虽 然 我 们 也 可 以 使 用 类 (Class) 来 定义 ， 
但 使 用 接口 的 好 处 更 明显 一 些 。 主 要 表现 在 如 下 方面 。 

@ ”便于 合约 的 继承 ， 不 同 的 类 型 可 以 自由 实现 相同 的 合约 。 

@ ”同一 服务 类 型 可 以 实现 多 个 合约 。 

@ ”和 接口 隔离 原则 相同 ， 我 们 随时 可 以 修改 服务 类 型 。 

@ ”便于 制定 版 本 升级 策略 ， 让 新 老 版 本 的 服务 合约 同时 使 用 。 

服务 合约 定义 了 WCF 服务 可 以 执行 的 操作 , 它 又 包括 ServiceContract 和 OperationContract 
两 种 。ServiceContract 用 于 类 或 者 接口 上 ， 用 于 指定 此 类 或 者 接口 能 够 被 远程 调用 ， 而 
OperationContract 用 于 类 中 的 方法 上 ， 用 于 指定 该 方法 可 被 远程 调用 。 

例如 ， 下 面 的 示例 代码 使 用 “ServiceContract” 属 性 声明 接口 IMyFirstService 可 以 被 远程 
调用 ，“OperationContract” 属 性 声明 getTime0 方 法 也 可 以 被 远程 调用 。 


[ServiceContract] 


public interface IMyFirstService 
{ 

[OperationContract] 

string getTime(); 
} 


在 表 13-4 中 列 出 了 ServiceContract 属性 的 可 用 选项 及 其 说 明 。 
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表 13-4 ServiceContract 属性 的 选项 及 说 明 


选 项 说 明 
ConfigurationName 用 于 定义 配置 文件 中 服务 配置 的 名 称 
CallbackContract 当 服 务 用 于 双向 消息 传递 时 ， 此 选项 定义 了 客户 端 程序 中 实现 的 合约 
Name 此 选项 定义 了 WSDL 中 portType 节点 的 名 称 
Namespace 此 选项 定义 了 WSDL 中 portType 节点 的 命名 空间 
on 此 选项 可 定义 调用 这 个 合约 的 操作 所 需 的 会 话 。 其 值 是 SessionMode 枚 举 值 , 可 
选 的 值 有 Allowed、NotAllowed 和 Required 
_ 此 选项 确定 了 绑 定 是 否 必须 能 保护 通信 。 其 值 是 ProtectionLevel 枚 举 值 , 可 选 的 
ProtectionLevel 


值 有 None、Sign 和 EntryptAndSign 


在 表 13-5 中 列 出 了 OperationContract 属性 的 可 用 选项 及 其 说 明 。 


选 项 
Action 


ReplyAction 
AsyncPattern 
IsInitiating 


IsTerminating 
IsOneWay 


Name 


ProtectionLevel 


表 13-5 OperationContract 属性 的 选项 及 说 明 


说 明 
WCF 使 用 SOAP 请 求 的 Action 选项 把 该 请 求 映射 到 相应 的 方法 上 。 因此 使 用 此 选项 
可 以 对 请 求 的 方法 进行 重 命名 
此 选项 用 于 设置 回应 消息 的 Action 名 称 
如 果 使 用 异步 模式 来 实现 操作 ， 则 可 以 将 此 选项 设置 为 rue 
如 果 合 约 由 一 系列 操作 组 成 ， 则 可 以 使 用 此 选项 指定 初始 化 时 执行 的 方法 
如 果 合 约 由 一 系列 操作 组 成 ， 则 可 以 使 用 此 选项 指定 结束 时 执行 的 方法 
使 用 此 选项 后 ， 客 户 端 程序 将 不 会 等 待 回 应 消息 。 因 此 在 发 送 请 求 消息 后 ， 单 向 操 
作 的 调用 者 就 无 法 直接 检查 是 否 失败 
操作 的 默认 名 称 是 方法 的 名 称 ， 使 用 此 选项 可 进行 重 命名 
此 选项 可 用 于 确定 消息 仅仅 是 签名 ， 还 是 应 先 加 密 后 签名 


加 $ 在 服务 合约 中 , 还 可 以 使 用 DeliveryRequirements 属性 定义 服务 的 传输 要 求 ; 使 用 
提示 RequireOrderedDelivery 属性 指定 所 传递 的 消息 必须 以 相同 的 顺序 到 达 ; 使 用 
QueuedDeliveryRequirements 属性 指定 消息 以 断 开 连接 的 方式 传送 。 


2. 数据 合约 


数据 合约 也 分 为 两 种 : DataContract 和 DataMember。DataContract 用 于 类 或 者 结构 上 ， 指 
定 此 类 或 者 接口 能 够 被 序列 化 并 传输 ， 而 DataMember 只 能 用 在 类 或 者 接口 的 属性 (Property) 或 
者 字段 (Field) 上 ， 指 定 该 属性 或 者 字段 能 够 被 序列 化 传输 。 

数据 合约 的 序列 化 不 同 于 普通 .NET 的 序列 化 机 制 ， 在 运行 时 所 有 的 字段 (包括 私有 字段 ) 
都 会 被 序列 化 , 而 在 执行 数据 合约 的 序列 化 时 只 有 被 标记 了 DataMember 的 属性 才 会 被 序列 化 。 


例如 ， 下 面 创 寻 


个 服务 合约 并 定义 了 一 个 Add() 方 法 接受 一 个 Person 类 型 的 参数 。 


一 个 Person 类 并 使 用 DataContract 属性 指定 为 可 序列 化 。 另 外 还 创建 了 一 
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[DataContract] 
public class Person 
! 
[DataMember] 
Public int Tdy 
[DataMember] 
public string Name; 
[DataMember] 
public DateTime Birthday; 
[DataMember] 
public string Email; 
} 
[ServiceContract] 
public interface IPerson 
{ 
[OperationContract] 
bool Addl(Person p); 
. 


在 表 13-6 中 列 出 了 DataMember 属性 可 用 的 选项 及 其 说 明 。 
表 13-6 DataMember 属性 的 选项 及 说 明 


选 项 说 明 
Name 序列 化 时 默认 名 称 与 类 中 的 声明 相同 ， 使 用 此 选项 可 以 进行 重 命名 
Order 获取 或 设置 成 员 的 序列 化 和 反 序 列 化 的 顺序 
IsRequired 获取 或 设置 一 个 值 ， 该 值 用 于 指定 序列 化 引擎 在 读 取 或 反 序 列 化 时 成 员 必 须 存在 
Es 获取 或 设置 一 个 值 ， 该 值 指定 是 否 对 正在 被 序列 化 的 字段 或 属性 的 默认 值 进 行 序 


列 化 。 默 认 值 为 tme 
例如 ， 我 们 要 对 Order 对 象 进行 序列 化 ， 它 的 定义 如 下 。 在 这 里 我 们 使 用 Namespace 选项 


重新 定义 了 命名 空间 。 对 于 数据 成 员 使 用 Name 选项 指定 了 一 个 别名 ， 使 用 Order 选项 指定 了 


显示 的 顺序 。 


显 


[DataContract (Namespace = "http://www.itzcn.com")] 
public class Order 
{ 
[DataMember (Name="OrderId",Order=1)] 
public Guid ID; 
[DataMember (Name="OrderDate",Order=2)] 
public DateTime Date; 
[DataMember] 
public string Customer; 
[DataMember] 
public string Address; 
public double TotalPrice; 
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执行 后 ，Order 对 象 的 序列 化 XML 如 下 所 示 : 


<Order xmlns:i="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www.itzcn.com"> 

<Address></Address> 

<Customer></Customer> 

<OrderId></OrderId> 

<OrderDate></OrderDate> 
</Order> 


通过 定义 的 数据 合约 以 及 与 最 终生 成 XML 结构 的 对 比 ， 我 们 可 以 总 结 出 WCF 默认 采用 
如 下 的 数据 合约 序列 化 规则 : 
@ XML 的 根 节点 为 数据 合约 中 类 的 名 称 ， 默 认命 名 空间 格式 为 
“http://schemas.datacontract.org/2004/07/{ 类 所 在 命名 空间 }”。 
@ ”只 有 使 用 DataMember 属性 定义 的 字段 或 者 属性 才能 作为 数据 成 员 参 与 序列 化 (例如 
本 实例 中 的 TotalPrice 属性 不 会 再 现在 序列 化 后 的 XML 中 )。 
@ 所 有 数据 成 员 均 以 XML 元 素 的 形式 被 序列 化 。 
@ 默认 数据 成 员 按 照 字母 顺序 排列 。 
@ ”如 果 通 过 Order 指定 了 顺序 ， 且 值 相同 ， 则 以 字母 先后 顺序 排列 。 
@ 未 指定 Order 的 成 员 顺 序 在 指定 Order 顺序 之 前 。 
@ 如果 DataContract 处 于 继承 的 类 中 ， 那 么 将 优先 显示 父 类 中 的 成 员 。 
3 


如 果 需 要 在 WCF 服务 中 对 SOAP 消息 进行 控制 则 必须 使 用 消息 合约 。 在 消息 合约 中 ， 可 
以 指定 消息 的 哪些 部 分 出 现在 SOAP 标题 中 ， 哪 一 部 分 要 放 在 SOAP 的 主体 中 。 
例如 ， 下 面 的 示例 演示 了 使 用 ProcessOrderMessage 类 定义 消息 合约 的 代码 。 
[MessageContract] 
public class ProcessOrderMessage 
[MessageHeader] 
public Guid ID; 
[MessageBodyMember] 
public Order order; 


y 
如 上 述 代码 所 示 ， 在 这 里 使 用 “MessageContract” 属 性 指定 ProcessOrderMessage 为 一 个 
消息 合约 ， 对 于 SOAP 消息 中 的 标题 使 用 “MessageHeader” 属 性 指定 ，SOAP 主体 使 用 
“MessageBodyMember” 属 性 指定 。 
为 了 使 用 上 面 定义 的 消息 合约 , 我 们 将 IProcessOrder 接口 定义 为 服务 合约 ,并 定义 了 一 个 
可 调用 的 ProcessOrder0 方 法 。 代 码 如 下 所 示 : 
[ServiceContract] 


public interface IProcessOrder 


{ 


[OperationContract] 


< 全 一 


ProcessOrderMessage ProcessOrder (ProcessOrderMessage message); 


} 


4. 异常 合约 

在 WCF 中 所 有 的 合约 基本 上 都 是 围绕 着 一 个 服务 调用 时 的 消息 交换 来 进行 的 。 例 如 ， 服 
务 的 客户 端 向 服务 的 提供 者 发 送 请 求 消息 ; 服务 提供 者 在 接收 到 该 请 求 后 激活 服务 实例 ， 并 调 
用 相应 的 服务 操作 ;最 终 将 返回 的 结果 以 回复 消息 的 方式 返回 给 服务 的 客户 端 。 

但 是 ， 如 果 服 务 操作 不 能 正确 地 执行 ， 服务 端 将 会 通过 一 种 特殊 的 消息 将 错误 信息 返回 给 
客户 端 ， 这 种 消息 被 称 为 异常 消息 。 对 于 异常 消息 ， 同 样 需要 相应 的 合约 来 定义 其 结构 ， 我 们 
把 这 种 合约 称 为 异常 合约 (Fault Contract)。 

WCF 通过 FaultContract 属性 来 定义 异常 合约 。 由 于 异常 合约 是 基于 服务 操作 级 别 的 ， 所 
以 该 属性 将 直接 应 用 于 服务 合约 接口 或 者 操作 合约 的 方法 上 。 

下 面 的 示例 代码 演示 了 FaultContract 定义 异常 合约 的 方式 。 

[ServiceContract] 


public interface IUser 


{ 


[OperationContract] 
[FaultContract (typeof (LoginTimeOut))] 
bool Login (string username, string userpass); 
} 
在 上 述 代 码 中 ， 使 用 FaultContract 属性 声明 调用 Login() 方 法 会 抛 出 LoginTimeOut 类 的 异 
常 ， 表 示 登 录 超时 。 
与 本 节 前 面 介绍 的 其 他 合约 一 样 ， 异 常 合约 的 FaultContract 属性 也 有 很 多 可 用 选项 ， 如 
表 13-7 中 列 出 了 它们 及 其 说 明 。 


表 13-7 FaultContract 属性 的 选项 及 说 明 


选 项 说 明 
i 此 选项 用 于 设置 当 操作 合约 出 现 SOAP 异常 消息 时 要 调用 的 操作 。 默 认 值 为 “当前 
操作 的 名 称 +Fault” 

. 此 选项 用 于 指定 封装 异常 信息 的 自 定义 类 ， 例 如 在 上 面 定 义 的 登录 超时 类 
DDS LoginTimeOut 
Name 此 选项 用 于 设置 WSDL 中 异常 消息 的 名 称 
Namespace 此 选项 用 于 设置 SOAP 异常 的 命名 空间 
HasProtectionLevel | 此 选项 用 于 设置 SOAP 异常 消息 是 否 分 配 有 保护 级 别 
ProtectionLevel 此 选项 用 于 设置 SOAP 异常 消息 要 绑 定 的 保护 级 别 


13.4 配置 WCF 端点 


上 一 节 我 们 对 WCF 服务 内 部 的 核心 概念 进行 了 详细 讲解 。 本 节 将 从 另 一 个 角度 来 介绍 


Ed) > 
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WCF， 那 就 是 端点 。WCF 端点 由 上 节 介 绍 的 地 址 、 绑 定 和 合约 组 成 , 它 定义 了 WCF 服务 如 何 
进行 通信 ， 以 及 使 用 什么 地 址 进行 通信 。 
= 视频 教学 : 光盘 /videos/13/ 配 置 WCF 端点 .avi Op 光 克 


每 个 WCF 服务 都 会 关联 到 一 个 用 于 定位 服务 位 置 的 地 址 ， 一 个 用 于 定义 如 何 与 服务 进行 
通信 的 绑 定 ， 以 及 一 个 告知 客户 端 服务 能 做 什么 的 合约 。 这 三 样 共同 组 成 了 服务 的 端点 。 

每 个 端点 都 必须 完整 拥有 这 三 个 组 成 部 分 ， 主 机 通过 公开 端点 来 对 外 提供 服务 。 理 论 上 ， 
端点 就 是 服务 的 外 部 交互 接口 ， 就 像 CLR 或 者 COM 接口 。 每 个 服务 至 少 需要 公开 一 个 端点 ， 
服务 上 所 有 的 端点 都 必须 拥有 唯一 的 定位 地 址 , 单个 服务 可 以 提供 多 个 端点 供 不 同 类 型 的 客户 
端 调用 。 这 些 端点 可 以 使 用 相同 或 不 同 的 绑 定 对 象 ， 可 以 拥有 相同 或 不 同 的 服务 契约 。 但 是 对 
于 单个 服务 的 不 同 端点 ， 它 们 之 间 没有 任何 关联 。 

下 面 对 如 何 通 过 配置 文件 和 编程 方式 定义 端点 进行 介绍 。 

1. 通过 配置 文件 方式 

这 种 方式 是 将 端点 的 信息 保存 到 主机 的 配置 文件 中 , 通常 是 app.config 文件 或 者 web.config 

文件 。 
假设 ， 我 们 使 用 如 下 代码 定义 了 一 个 服务 合约 及 其 实现 类 。 

// 指 定 命名 空间 


namespace MYNameSpace 


{ 


[ServiceContract] 
public interface IMyContract 
{ 
// 这 里 是 IMycontract 接口 的 定义 
} 
public class MyService : IMyContract 
{ 
// 这 里 是 IMycontract 接口 的 实现 
} 
} 


如 下 给 出 了 针对 这 个 WCF 服务 的 端点 信息 ， 其 中 包含 服务 的 完整 名 称 、 绑 定 类 型 、 合 约 
的 完整 名 称 等 。 


<system.serviceModel> 
<services> 


<service name = "MyNameSpace.MyService"> 


<endpoint 
address = "http://localhost:8000/MyService/" 
binding = "wsHttpBinding" 
contract = "MyNameSpace.IMyContract™" 
> 
</service> 
</services> 


</system.serviceModel> 


< 


@ $ 在 这 里 指定 的 服务 名 称 和 服务 合约 必须 是 带 命名 空间 的 完整 名 称 ， 否 则 将 无 法 正 
注意 | 。 确 引用 其 地 址 。 而 且 地 址 的 类型 与 绑 定 类 型 必须 匹配 ， 否 则 就 会 在 加 载 服务 时 导 
致 异常 


当然 , 我 们 可 以 在 配置 文件 中 为 一 个 单独 的 服务 提供 多 个 端点 设置 。 这 些 端 点 可 以 使 用 相 
同 的 绑 定 类 型 ， 但 是 必须 保证 URL 是 唯一 的 。 例 如 ， 如 下 是 多 个 端点 的 示例 配置 文件 : 


<service name = "MyService"> 
<endpoint 
address = "http://localhost:8000/MyService/" 
binding = "wsHttpBinding" 
contract = "IMyContract" 
/> 
<endpoint 
address = "net.tcp://localhost:8001/MyService/" 
binding = "netTcpBinding" 
contract = "IMyContract" 
> 
<endpoint 
address = "net.tcp://localhost:8002/MyService/" 
binding = "netTcpBinding" 
contract = "IMyOtherContract" 
全 
</service> 


我 们 还 可 以 提供 一 个 或 多 个 默认 的 基本 地 址 (Base Address), 这 样 在 端点 设置 中 只 需 提供 相 
对 地 址 。 多 个 基本 地 址 之 间 不 能 冲突 ， 不 能 在 同一 个 端口 进行 监听 。 
相对 地 址 通过 端点 绑 定 类 型 与 基本 地 址 进行 匹配 ， 从 而 在 运行 时 获得 完整 地 址 。 如 果 将 某 
个 端点 设置 中 的 地 址 设 为 空 值 (省 略 address)， 则 表示 直接 使 用 某 个 相 匹配 的 基本 地 址 。 
例如 ， 如 下 的 配置 文件 演示 了 这 种 方式 : 
<service name = "MyService"> 
<host> 
<baseAddresses> 
<add baseAddress="http://localhost:8080/" /> 
<add baseAddress="net.tcp://localhost:8081/" /> 


</baseAddresses> 
</host> 
<endpoint 
address = "MyService" <!-- http://localhost:8080/MyService --> 
binding = "wsHttpBinding" 
contract = "IMyContract™" 
we 
<endpoint 
address = "MyService" <!-- net.tcp://localhost:8081/MyService --> 
binding = "netTcpBinding" 
contract = "IMyContract™" 


全 


第 13 章 WCF 快速 入 门 [ 


<endpoint 
address = "net.tcp://localhost:8002/MyService/" 
binding = "netTcpBinding" 
contract = "IMyOtherContract™" 
> 
</service> 


此 外 ， 还 可 以 进一步 对 端点 中 的 绑 定 参数 进行 设置 。 每 种 绑 定 类 型 可 拥有 多 个 名 称 不 同 的 
参数 设置 ， 然 后 在 端点 的 bindingConfiguration 属性 中 指定 关联 设置 名 称 。 

例如 ， 在 下 面 的 配置 文件 中 使 用 bindingConfiguration 属性 指定 关联 名 称 为 
TransactionalTCP 的 绑 定 信息 。 


<system.serviceModel> 


<services> 
<service name = "MyService"> 
<endpoint 
address = "net.tcp://localhost:8000/MyService/" 
bindingConfiguration = "TransactionalTCP" 
binding = "netTcpBinding" 
contract = "IMyContract" 
> 
</service> 
</services> 
<bindings> 
<netTcpBinding> 


<binding name = "TransactionalTCP" 
transactionFlow = "true" 
全 
</netTcpBinding> 
</bindings> 
</system.serviceModel> 


2. 通过 编程 方式 

编程 方式 配置 端点 与 使 用 配置 文件 的 方式 是 等 效 的 。 它 的 优点 是 不 需要 编写 额外 的 配置 文 
件 ， 而 是 通过 编程 的 方式 将 端点 添加 到 ServiceHost 实例 中 。 如 下 所 示 为 创建 ServiceHost 实例 
时 可 用 的 两 个 构造 函数 形式 : 

public ServiceHost (object singletonInstance, params Uri[] baseAddresses); 

public ServiceHost (Type serviceType, params Uri[] baseAddresses); 


ServiceHost 提供 了 一 个 AddServiceEndpoint() 方 法 向 当前 的 服务 中 添加 端点 。 如 下 所 示 为 
该 方法 的 重 载 形式 : 


public ServiceEndpoint AddServiceEndpoint (Type implementedContract, Binding 


binding, string address); 

public ServiceEndpoint AddServiceEndpoint (Type implementedContract, Binding 
binding, Uri address); 

public ServiceEndpoint AddServiceEndpoint (Type implementedContract, Binding 


< 


binding, string address, Uri listenUri); 


public ServiceEndpoint AddServiceEndpoint (Type implementedContract, Binding 


binding, Uri address, Uri listenUri); 


在 使 用 时 address 参数 可 以 是 相对 地 址 ， 也 可 以 是 绝对 地 址 ， 这 与 使 用 配置 文件 是 一 致 的 。 


ServiceHost host = new ServiceHost (typeof (MyService)); 
Binding wsBinding = new WSHttpBinding( ); 

Binding tcpBinding = new NetTcpBinding( ); 
host.AddServiceEndpoint (typeof (IMyContract), wsBinding, 
"http://localhost:8000/MyService"); 
host.AddServiceEndpoint (typeof (IMyContract), tcpBinding, 
"net.tcp://localhost:8001/MyService"); 
host.AddServiceEndpoint (typeof (IMyOtherContract), tcpBinding, 
"net.tcp://localhost:8002/MyService"); 

host.Open( ); 


13.5 创建 WCF 服务 主机 


我 们 已 经 看 到 ， 在 WCF 中 客户 端 和 服务 端 是 通过 端点 来 通信 的 。 而 WCF 服务 主机 实际 
就 是 把 一 个 服务 置 于 一 个 运行 的 进程 中 ,然后 再 向 客户 端 公 开 可 调用 的 端点 ， 并 监听 来 自 客户 
端的 请 求 。 
ce 视频 教学 : 光盘 /videos/13/WCEF 服务 主机 .avi 人 @@ 长 度 : 2 分 名 

在 WCF 中 指定 WCF 的 启动 主机 时 有 很 多 选择 。 主 机 可 以 是 Windows 服务 、COM+ 应 用 
程序 、ASP.NET 应 用 程序 、Windows 应 用 程序 或 者 控制 台 应 用 程序 。 

例如 ， 下 面 给 出 的 示例 代码 使 用 控制 台 应 用 程序 来 启用 WCEF 主机 。 

static void Main(string[] args) 


{ 


using (ServiceHost host = new ServiceHost ()) 


{ 
host .Open(); 
Console.Write ("服务 已 经 启动 ， 按 任意 键 结束 服务 !") ; 
Console.Read (); 
host.Close(); 
' 


} 


可 以 看 到 ， 在 Main() 方 法 中 创建 了 一 个 ServiceHost 实例 。 接 着 ， 读 取 应 用 程序 配置 文件 
来 定义 绑 定 ， 也 可 以 像 前 面 介绍 的 那样 通过 编程 定义 绑 定 。 再 往 下 调用 ServiceHost 实例 的 
Open0 方 法 使 服务 可 以 接受 客户 端的 调用 。 最 后 ， 在 使 用 完成 后 调用 Close0 方 法 结束 服务 。 


m= > 
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”如 果 要 中 止 WCF 服务 主机 ， 可 以 调用 ServiceHost 实例 的 Abort0 方 法 。 还 可 以 使 
提示 | 。 用 它 的 State 属性 获取 当前 服务 的 状态 。 


13.6 ”实现 除法 运算 的 WCF 服务 


学 到 此 处 ， 相 信 读 者 一 定 对 WCF 有 了 更 深 的 了 解 ， 而 且 应 该 能 够 根据 项 目的 需求 合理 设 
计 WCE 服务 了 。 例 如 ， 根 据 网 络 情况 选择 一 种 通信 协议 、 设 计 一 种 绑 定 方式 以 及 使 用 合约 指 
定 可 被 调用 的 方法 。 

本 节 将 通过 一 个 完整 的 实例 总 结 WCF 服务 的 应 用 。 实 例 运行 在 控制 台 下 ， 实 现 了 除法 运 
算 并 可 以 对 除数 为 零 的 情况 进行 捕捉 。 


ci 视频 教学 :光盘 /videos/13/ 除 法 运算 WCF 服务 .avi @@ 长 度 : 8 分钟 


13.6.1 ”实例 描述 


本 实例 使 用 WCEF 服务 库 项 目 作为 服务 器 ， 一 个 控制 台 程序 作为 客户 端 。 然 后 客户 端 通过 
服务 引用 建立 对 WCF 的 连接 ， 再 调用 WCF 提供 的 方法 实现 除法 运算 。 整 个 实例 的 制作 过 程 
都 在 Visual Studio 2010 中 完成 。 


13.6.2 ”实例 应 用 


【 例 13-2】 实现 除法 运算 的 WCF 服务 

(1) 在 Visual Studio 2010 中 新 建 一 个 名 为 “CalculatorWcfServiceLibrary” 的 WCF 服务 库 
项 目 。 

(2) 按照 WCF 的 开发 流程 ， 先 定义 服务 再 实现 ， 最 后 调用 。 这 里 向 项 目 中 添加 一 个 名 为 
ICalculator.cs 的 接口 。 

(3) 在 接口 中 声明 一 个 用 于 执行 除法 运算 的 Divide0 方 法 ， 然 后 将 接口 和 方法 设置 为 可 被 
远程 调用 ， 代 码 如 下 所 示 : 

[ServiceContract (Namespace = "http://www.itzcn.com")] 


public interface ICalculator 


{ 


[OperationContract] 

[FaultContract (typeof (MathError))] 

double Divide(double x, double y); 
} 


(4) 在 上 述 代码 中 使 用 FaultContract 属性 定义 了 一 个 MathError 类 型 的 异常 合约 。 这 一 步 
我 们 创建 这 个 MathError 类 , 由 于 它 将 在 WCF 服务 中 使 用 , 因此 又 使 用 DataContract 属性 设置 
为 数据 合约 。 具 体 实现 代码 如 下 所 示 : 


57 


[DataContract] 
public class MathError 


{ 


public MathError(string operation, string errorMessage) 


{ 
this.Operation = operation; 


this.ErrorMessage = errorMessage; 


} 
[DataMember] 

public string Operation { get; 
[DataMember] 

public string ErrorMessage { get; 


set 


ee 


» 
(5) 下 面 来 编写 接口 的 实现 代码 。 在 项 目 中 添加 一 个 名 为 CalculatorService 的 类 ， 使 它 实 


现 ICalculator 接口 。CalculatorService 类 的 完整 代码 如 下 所 示 : 


public class CalculatorService : ICalculator 


{ 
double y) 


public double Divide (double x, 
{ 
是 WE WO 
new MathError (" 除 法 "， "被 除数 不 能 为 零 。") ; 


MathError error = 
new FaultReason 


throw new FaultException<MathError> (error, 
("参数 传递 无 效 。")，new FaultCode ("sender")); 


于 
return x / Y7 


} 
(6) 完成 CalculatorService 类 的 代码 后 ， 打 开 项 目 中 的 App.config 文件 。 在 这 号 


设计 服务 的 端点 信息 ， 最 终 内 容 如 下 所 示 : 


配置 上 面 


<services> 
<service name="CalculatorWcfServiceLibrary.CalculatorService"> 


<endpoint address="" binding="wsHttpBinding" contract=" 
CalculatorWcfServiceLibrary.ICalculator"> 
<identity> 
<dns value="localhost" /> 
</identity> 


</endpoint> 
<endpoint address="mex" binding="mexHttpBinding" contract=" 


IMetadataExchange" /> 


<host> 
<baseAddresses> 
<add baseAddress="http://localhost:8732/ 


CalculatorWcfServiceLibrary/CalculatorService/" /> 
</baseAddresses> 
</host> 
</service> 
</services> 


第 13 章 WCF 快速 入 门 区 


(7) 到 这 一 步 针 对 WCEF 项 目的 工作 就 完成 了 ， 我 们 可 以 直接 运行 测试 。 这 里 我 们 使 用 控 
制 台 进行 测试 ， 所 以 向 解决 方案 中 添加 一 个 名 为 “TestCalculatorConsoleApplication” 的 控制 台 


应 用 程序 。 


(8) 右 击 项 目 选 择 【 添 加 服务 引用 命令 , 打开 【添加 服务 引用 】 对 话 框 。 在 这 里 单 击 【 发 
现 】 按 钮 来 查找 本 解决 方案 中 的 服务 。 找 到 后 会 看 到 服务 的 URL 地 址 ， 以 及 可 调用 的 操作 。 
在 下 方 的 【命名 空间 】 文 本 框 中 设置 值 为 “ServiceReferencel1”， 最 后 单 击 【 确 定 】 按 钮 完成 


引用 ， 如 图 13-13 所 示 。 


和 


纺 址 ); 
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13-13 【添加 服务 引用 】 对 话 框 


(9) 在 控制 台 程序 中 添加 对 如 下 命名 空间 的 引用 。 


using System.ServiceModel; 


using TestCalculatorConsoleApplication.ServiceReferencel; 


(10) 在 Main0 方 法 中 编写 具体 的 实现 代码 ， 包 括 实例 化 WCF 服务 类 ， 调 用 方法 ， 输 出 结 


果 以 及 处 理 异常 等 。 完 整 代码 如 下 所 示 : 


static void Main(string[] args) 
{ 
ServiceReferencel.CalculatorClient Calc = 
CalculatorClient (); 
try 
| 
Console .WriteLine ("执行 第 一 次 除法 运算 ") ; 
Console.WriteLine("x / y = {2} when x 
Calc.Divide(4, 2)); 
Console.WriteLine(); 
Console.WriteLine ("执行 第 二 次 除法 运算 ") ; 
Console.WriteLine("x / y = {2} when x 
Calc.Divide(9, 2)); 
Console.WriteLine(); 
Console.WriteLine ("执行 第 三 次 除法 运算 ") ; 
Console.WriteLine("x / y = {2} when x 
Calc.Divide(9, 0)); 
Console.WriteLine(); 
1 
catch (FaultException<MathError> ex) 


new ServiceReferencel. 


= {0} and y = {1}", 4, 2, 
= {0} and y = {1}", 9 2, 
= {0} and y = {1}", 9, 0, 


< 


必 坟 We 服务 开发 学 习 实录 - 


{ 

MathError error = ex.Detail; 

Console.WriteLine("An Fault is thrown.\n\tFault code:{0}\n\ 
tFault Reason:{1l}\n\tOperation:{2}\n\tMessage:{3}", ex.Code, 
ex.Reason, error.Operation, error.ErrorMessage); 

} 
catch (Exception ex) 
{ 

Console.WriteLine ("An Exception is thrown.\n\tException Type:{0} 

\n\tError Message:{1}", ex.GetType(), ex.Message); 
} 


Console.WriteLine(); Console.WriteLine (" 按 任意 键 退出 程序 !") ; 
Console.ReadKey () 


} 


(11) 右 击 解决 方案 选择 【生成 解决 方案 】 命 令 ， 生 成 上 面 创建 的 项 目 ， 完 成 实例 的 制作 。 
13.6.3 ”运行 结果 


在 控制 台 程 序 中 按 F5 键 执行 , 此 时 Visual Studio 2010 将 在 “http://localhost:8732/Calculator 
WefServiceLibrary/CalculatorService ”位 置 启 动 WCF 服务 主机 等 待 调用 。 
待 执行 到 除法 运算 时 ， 由 于 设置 了 被 除数 为 零 的 情况 ， 所 以 首先 会 看 到 如 图 13-14 所 示 的 


提示 。 


生生 二 EEE 


图 13-14 ”被 除数 为 零 时 的 异常 提示 


按 F5 键 继续 运行 ,此 异常 将 会 被 WCF 服务 的 调用 方 捕捉 到 ， 并 看 到 如 图 13-15 所 示 的 运 
行 效果 。 


13-15 ”运行 效果 
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13.6.4 ”实例 分 析 


se 


在 实例 中 演示 了 WCEF 服务 的 另 一 个 引用 方式 ， 即 通过 添加 服务 引用 来 完成 。 这 种 方式 省 
掉 了 手动 执行 命令 、 生 成 代理 和 添加 文件 等 复杂 的 步骤 。 从 而 使 开发 人 员 可 以 更 专心 地 编写 
WCF 服务 的 业务 逻辑 以 及 实现 。 

本 实例 实现 的 功能 虽然 很 简单 ， 但 是 它 用 到 了 本 章 介 绍 的 所 有 WCF 知识 。 最 重要 的 是 使 
读者 掌握 WCF 服务 应 用 程序 的 开发 流程 。 

最 后 要 注意 ，WCEF 的 很 多 功能 都 依赖 于 System.ServiceModel 命名 空间 。 因 此 ， 在 设计 时 
第 一 步 就 是 添加 对 它 的 引用 。 


13.7 ”常见 问题 解答 


13.7.1 WCF 中 的 合约 和 哪 种 技术 比较 类 似 


WCF 中 的 合约 和 哪 种 技术 比较 类 似 ? 
网 络 课堂 : http:Wbbs.itzcn.conxy/thread-15741-1-1.html 


向 各 位 大 侠 请 教 一 下 ，WCEF 中 的 合约 和 哪 种 技术 比较 相像 ， 又 有 什么 不 同 呢 ? 
【解决 办 法 】 

如 果 非 要 拿 合 约 和 以 往 的 技术 相 比 较 。 合 约 和 ASP.NET Web Service 的 声明 性 编程 模型 非 
常 相似 。 例 如 ， 在 Web Service 中 的 类 上 标记 WebService 属性 便 可 以 将 此 类 用 于 远程 调用 ， 而 
将 方法 添加 WebMethond 属性 也 可 以 将 其 暴露 给 远程 客户 端 。 这 和 WCF 中 的 ServiceContract 
及 OperationContract 简直 如 出 一 辐 。 

但 不 同 的 是 ，WCF 中 的 合约 要 比 WebService 中 的 详尽 ， 例 如 ，ServiceContract 和 
OperationContract 可 以 直接 使 用 在 接口 上 面 ， 而 实现 该 接口 的 类 就 继承 了 这 种 合约 声明 。 自 动 
拥有 合约 所 规范 的 动作 和 行为 ， 这 就 使 得 程序 员 更 方便 地 使 用 面向 接口 的 编程 方式 。 从 而 可 以 
使 同一 服务 拥有 不 同 的 实现 ， 能 够 使 新 老 版 本 共同 运行 。 


13.7.2 ”菜鸟 请 教 一 个 WCF 问题 


菜鸟 请 教 一 个 WCF 问题 ? 
网 络 课堂 : http://bbs.itzen.com/thread-15742-1-1.html 


我 创建 了 一 个 WefServiceLibraryl 和 一 个 ConsoleApplication1, 然后 在 ConsoleApplication1 
里 添加 服务 引用 。 请 问 以 下 几 个 问题 : 


< 针 一 — 


(1) 那么 是 不 是 说 ConsoleApplicationl 就 是 客户 端 ，WcefServiceLibrary1 就 是 服务 端 ? 

(2) 如 果 是 的 话 ， 在 客户 端 “ServiceHost host = new ServiceHost(typeof(UserService)); 
host.Open(0:” 启 动 服务 后 ， 怎 么 调用 服务 端的 方法 呢 ? 

(3) 还 有 这 样 一 种 写法 “IServicel s = new ServicelClient():serv.GetData(23)”。 这 又 是 什么 
意思 呢 ? 

【解决 办 法 】 

WCF 的 服务 器 端 一 般 分 成 三 个 部 分 。 第 一 个 是 Contract, 这 部 分 和 Client 应 该 是 公用 同一 
个 dl 文件 ， 用 于 定义 数据 规范 。 第 二 个 是 主机 程序 ， 可 以 是 IS， 可 以 是 Console 或 者 其 他 类 
型 程序 ， 用 来 加 载 和 开启 服务 ， 一 直 监 听 并 等 待 Client 的 请 求 。 第 三 个 是 提供 Service 的 dll， 
也 就 是 实现 Contract 中 定义 的 Service。 

Client 方面 ， 除 了 Contract， 就 是 和 服务 器 交互 的 那个 类 。 

根据 你 的 描述 ， 应 该 是 WefServiceLibraryl 用 于 提供 Service 接口 ，ConsoleApplication1 
程序 用 于 启用 WCF 服务 。 那 么 在 该 程序 中 会 用 到 “ServiceHost host = new ServiceHost(typeof 
(UserService)); host.Open0;” 代 码 启动 WCF 服务 。 


13.7.3 ”WCF 使 用 时 的 问题 


WCF 使 用 时 的 问题 ? 
网 络 课堂 : http://bbs.itzen.com/thread-15743-1-1.html 


我 用 Visual Studio 2010 创建 了 一 个 WCF 的 服务 库 , 然后 创建 了 客户 端 , 并 添加 服务 引用 ， 
此 时 生成 了 一 个 配置 文件 。 请 问 以 下 几 个 问题 。 

(1) 客户 端 生 成 的 配置 文件 是 根据 服务 端的 设置 生成 的 吗 ? 客户 端 还 需要 在 这 基础 上 配 
置 什 么 ? 

(2) 网 上 说 用 微软 自 带 的 什么 命令 工具 生成 客户 端 配 置 文件 , 生成 的 是 什么 配置 文件 啊 ? 

(3) WCF 能 用 UDP 协议 传输 图 片 文件 吗 ? 

(4) WCF 客户 端 怎么 向 服务 器 发 送 文 本 和 图 片 呢 (不 用 socket 传输 )? 

【解决 办 法 】 

(1) 添加 引用 的 时 候 是 根据 地 址 找到 服务 的 , 所 以 生成 的 客户 端 配置 文件 自然 要 包含 一 些 
服务 器 端的 信息 。 因 此 ， 可 以 说 是 根据 服务 器 端的 设置 生成 的 。 如 果 你 是 用 Visual Studio 2010 
添加 服务 引用 的 ， 基 本 上 不 用 其 他 的 配置 了 。 

(2) 那 是 生成 客户 端 代理 的 工具 ， 命 令 为 sveutil.exe。 它 生成 客户 端 代理 的 同时 会 同时 生 
成 一 个 配置 文件 ， 在 客户 端 用 。 

(3) WCE 中 有 个 binding 的 概念 。binding 描述 了 服务 传输 的 通信 方式 ， 使 用 绑 定 可 以 指 
定 传输 协议 、 安 全 要 求 、 编 码 方式 、 事 务 处 理 要 求 和 可 靠 性 等 。 另 外 ，WCE 的 binding 没有 基 
于 UDP 协议 的 绑 定 ， 主 要 以 TCP 和 HTTP 为 主 。 

(4) 具体 的 实现 过 程 没 有 试 过 ， 但 是 应 该 不 是 问题 。 基 本 思路 : 文件 一 流 一 根据 WCF 中 
文件 传输 的 方法 进行 文件 流传 输 一 转化 为 目的 文件 。 


m= >> 
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13.8 习 题 

一 、 填 空 题 

(1) WCF 是 由 开始 引入 ， 主 要 用 于 处 理 进程 之 间 消 息 的 传递 。 

(2) 在 一 个 WCF 服务 中 部 分 决定 了 服务 的 运行 环境 。 

(3) 每 个 WCF 端点 都 由 绑 定 、 和 合约 组 成 ， 其 中 指定 如 何 与 外 界 

(4) 为 了 创建 一 个 WCF 服务 ， 需 要 在 类 中 使 用 属性 声明 服务 合约 ， 使 用 
属性 声明 操作 合约 。 

(5) WCEF 支持 的 传输 方式 有 Peer Network、 、TCP、IPC 和 

(6) 对 于 一 个 WCF 主机 ， 可 以 调用 ServiceHost 实例 的 方法 启动 服务 ， 
方法 中 止 服务 ， 方法 结束 服务 。 

二 、 选 择 题 


(1) 下 面 关 于 WCF 的 描述 ， 不 正确 的 是 
A.， WCF 是 一 个 面向 Windows 编程 的 分 布 式 架构 
B. WCF 集成 了 DCOM、Enterprise Service 以 及 Web Service 
C. 使 用 WCF 可 以 对 服务 进行 定制 、 发 布 与 运行 
D. WCF 解决 了 跨 平台 特性 


(2) 在 WCF 中 使 用 来 定义 访问 地 址 。 

A. Contract B. Binding C. Address D. EndPoint 
(3) WCEF 的 合约 必须 要 以 的 方式 定义 。 

A. 类 B. 接口 C. 结构 D. 数组 


(4) 为 了 能 够 创建 和 使 用 WCF， 必 须 在 项 目 中 引用 命名 空间 
A. System.ServiceModel 
B. System.Web.WCF 
C. System.WCF 
D. System.Net.WCF 
(5) 对 于 一 个 WCF 地址 ， 下 面 选项 是 错误 的 。 
A. http://localhost:2156/services/wcf 
B. net.pipe:// localhost:2156/services/wcf 
C. ip://192.168.0.135:2156/services/wcf 
D. net.tcp:// localhost:2156/services/wcf 
(6) 下列 给 出 的 绑 定 类 型 中 ， 类 型 不 是 使 用 二 进 制 编码 进行 通信 的 。 
A. NetMsmqBinding 
B. NetTcpBinding 
C. NetMsmqBinding 


< 人 ———_— 


@,.. 服务 开发 学 习 实 录 . 


D. WSHttpBinding 


(7) WCF 中 DataContract 属性 的 选项 可 以 设置 成 员 的 序列 化 顺序 。 
A. Order B. IsRequired C. Action D. DetaillType 
三 、 上 机 练习 


上 机 练习 1: 创建 一 个 简单 的 WCF 服务 应 用 程序 。 
本 章 详细 介绍 了 WCF 服务 的 核心 概念 、 组 成 部 分 以 及 WCEF 服务 的 编写 和 调用 方法 。 在 
本 次 上 机 练习 中 要 求 读者 根据 下 面 的 要 求 创建 一 个 WCF 服务 ， 并 编写 相应 的 配置 文件 、 
ASP.NET 客户 端 程序 ， 并 最 后 在 浏览 器 中 查看 结果 。 
(1) WCF 服务 中 包含 一 个 名 为 “IServicel” 的 接口 ， 由 它 实现 服务 合约 。 
(2) 使 用 如 下 代码 声明 一 个 返回 字符 串 类 型 的 FormatDateTime() 方 法 , 它 根 据 format 参数 
格式 化 当前 时 间 。 
[OperationContract] 
string FormatDateTime (string format); 
(3) 使 用 如 下 代码 声明 一 个 返回 浮 点 类 型 的 GetTemperature() 方 法 ， 它 根据 zipCode 参数 
返回 指定 城市 的 当前 温度 。 
[OperationContract] 
float GetTempearture(string zipCode); 
(4) 使 用 如 下 代码 声明 一 个 返回 City 类 型 的 GetWeatherInfoById0) 方 法 ， 它 根据 Id 参数 
返回 一 个 自 定义 的 City 类 型 。 
[OperationContract] 
[FaultContract (typeof (WeatherInfoError))] 
City GetWeatherIinfoById(string cId); 
(5) 创建 GetWeatherInfoById0 方 法 所 需 的 City 类 和 WeatherInfoError 类 。 
(6) 创建 一 个 名 为 “Servicel” 的 类 继承 IServicel 接口 ， 并 编写 实现 代码 。 
(7) 修改 WCF 的 配置 文件 ,使 用 HTTP 地 址 http://localhost:8080/MyWcfService 进行 绑 定 。 
(8) 创建 一 个 ASP.NET 应 用 程序 ， 添 加 对 WCE 的 服务 引用 ， 并 在 页 面 显示 输出 结果 。 


mS >> 
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内 容 摘要 : 

相信 所 有 的 读者 都 用 过 QQ 之 类 的 一 些 聊天 工具 吧 ， 一 定 感觉 非常 不 错 ! 

对 于 身 处 软件 开发 行业 的 我 们 来 说 ,也 不 只 一 次 地 梦想 要 开发 一 个 类 似 QQ 一 样 的 聊天 工 
具 ， 以 供 所 有 人 使 用 。 

当然 ， 使 用 NET 实现 一 个 简单 的 聊天 功能 的 应 用 程序 并 不 难 ， 但 是 像 他 们 这 些 最 早 的 网 
络 服务 提供 商 来 说 ， 基 本 上 使 用 的 是 直接 操作 网 络 流 的 方式 (比如 Socket， 网 络 应 用 程序 套 接 
字 )。 使 用 这 些 传统 的 方法 执行 网 络 信息 传递 非常 费事 ， 而 且 容 易 出 问题 。 

Web 服务 提供 了 一 种 很 简便 的 操作 服务 器 远程 方法 的 机 制 , 可 以 让 我 们 像 使 用 本 地 应 用 程 
序 一 样 访问 网 络 中 的 一 些 服 务 。 

在 ASPNET 中 ， 因 为 它 对 访问 网 络 的 操作 进行 了 封装 ， 所 以 我 们 可 以 使 用 ASP.NET Web 
服务 很 方便 地 调用 远 端 方法 ， 以 实现 服务 器 和 客户 端 之 间 的 数据 传递 。 有 了 Web 服务 ， 我 们 
距 编 写 一 个 属于 自己 的 聊天 工具 的 梦想 就 越 来 越 近 了 。 

本 章 ， 我 们 就 在 ASP.NET 中 使 用 Web 服务 来 开发 一 个 简单 的 网 络 聊天 工具 。 


学 习 目 标 : 

@ 掌握 Web 服务 的 创建 方法 

掌握 使 用 应 用 程序 调用 Web 服务 的 方法 
掌握 Web 服务 中 用 户 状态 保持 的 方法 
掌握 使 用 Web 服务 传递 二 进 制 文件 的 方法 


14.1 系统 需求 和 应 用 程序 设计 


一 个 聊天 工具 ， 最 基本 的 需要 是 区 分 不 同 的 聊天 者 ， 所 以 这 里 需要 有 不 同 的 用 户 。 

在 这 个 聊天 应 用 程序 系统 中 会 有 非常 多 的 用 户 , 我 们 需要 让 用 户 有 选择 性 地 添加 自己 喜欢 
的 一 些 用 户 与 之 聊天 ， 所 以 这 个 系统 中 需要 有 “添加 好 友 ” 这 项 功能 。 当 然 好 友 也 不 可 能 让 你 
随意 想 添 就 添 了 ， 我 们 还 需要 实行 相应 的 好 友 验 证 功能 。 

剩 下 的 ， 就 是 最 基本 的 聊天 功能 了 。 

当然 ， 为 了 更 加 适用 ， 我 们 还 在 该 应 用 程序 中 添加 了 “传送 文件 ”的 功能 ， 让 聊天 者 可 以 
在 聊天 的 同时 更 加 方便 地 使 用 文件 来 交流 一 些 信息 。 


\ 
多 不 过 这 里 为 应 用 程序 的 性 能 考虑 ， 限 制 用 户 只 能 发 送 大 小 在 10KB 以 下 的 文件 ， 
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综合 


上 面 的 这 些 需 求 ， 我 们 的 应 用 程序 需要 包含 以 下 几 个 功能 。 

用 户 注册 : 用 户 注册 功能 允许 所 有 运行 我 们 的 客户 端 应 用 程序 的 用 户 执行 ， 用户 的 注 
册 信 息 通 过 Web 服务 提交 到 Web 服务 器 中 。 注 册 成 功 的 用 户 可 以 使 用 登录 和 聊天 等 
其 他 功能 。 

用 户 登 录 : 用 户 需 要 登录 以 后 才能 执行 添加 好 友和 聊天 等 功能 。 

添加 好 友 : 新 用 户 注册 以 后 , 没有 一 个 好 友 , 我 们 需要 在 登录 以 后 为 该 用 户 添加 好 友 。 
添加 好 友 操 作 需 要 由 当前 登录 用 户 向 对 方 发 出 请 求 ， 并 等 待 对方 验 证 ， 验 证 通过 以 后 
才 算 好 友 添 加 成 功 。 这 里 要 求 不 能 向 不 存在 的 用 户 发 出 好 友 请 求 ， 不 能 向 好 友 发 出 请 
求 ， 当 前 用 户 向 同一 个 用 户 发 出 好 友 请 求 以 后 ， 系 统 只 接收 一 次 请 求 ， 而 对 其 他 请 求 
默认 放弃 。 

好 友 验 证 : 用 户 在 接收 到 其 他 用 户 的 好 友 请 求 以 后 ， 可 以 选择 接受 请 求 或 者 拒绝 该 用 
户 请 求 。 当 用 户 接受 某 用 户 的 好 友 请 求 以 后 ， 只 说 明 当 前 用 户 自 己 成 为 那个 用 户 的 好 
友 ， 而 自己 用 户 列表 中 并 没有 出 现 那个 发 出 好 友 请 求 的 用 户 。 

发 送 消息 : 当前 登录 用 户 可 以 选中 好 友 列 表 中 的 某 一 位 好 友 ， 向 其 发 送 文本 消息 。 如 
果 用 户 没 有 选中 任意 一 位 好 友 ， 提 示 只 能 给 好 友 发 送 消息 ; 如 果 用 户 没有 输入 任何 消 
息 内 容 ， 则 放弃 当 次 消息 的 发 送 。 

发 送 文件 : 用 户 可 以 向 好 友 发 送 不 大 于 10KB 的 任意 类 型 的 文件 。 当 然 ， 接 受信 息 的 
用 户 可 以 选择 接收 或 放弃 接收 该 文件 。 


整个 系统 各 功能 的 运行 流程 如 图 14-1 所 示 。 
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添加 好 友 


发 送 文件 


图 14-1 系统 各 功能 执行 流程 


14.1.2 ”应 用 程序 设计 


知道 了 应 用 程序 的 整个 功能 需求 ， 我 们 就 可 以 着 手 来 设计 应 用 程序 了 。 

1. 应 用 程序 结构 

该 应 用 程序 使 用 C/S(Client/Server) 结 构 的 设计 。 服 务 器 端 采 用 ASP.NET Web 服务 作为 整 
个 系统 的 核心 ， 也 是 数据 中 心 。 客 户 端 使 用 NET Windows Form 应 用 程序 实现 ， 请 求 调用 Web 
服务 来 实现 数据 交换 。 

在 服务 器 端 使 用 三 层 架 构 ， 数 据 库 使 用 SQL Server。 在 数据 访问 层 使 用 LINQ to SQL 来 封 
装 操作 数据 库 的 方法 ， 然 后 在 业务 逻辑 层 使 用 LINQ 来 操作 数据 对 象 取得 数据 ， 并 处 理应 用 程 
序 业务 。 

如 此 ， 整 个 应 用 程序 结构 如 图 14-2 所 示 。 


Web 服 务 器 


14-2 ”应 用 程序 结构 


2. 数据 库 设计 
在 该 系统 中 ， 我 们 需要 抽出 来 几 个 名 词 : 用 户 、 好 友 、 消 息 、 文 件 、 好 友 请 求 信息 、 好 友 
响应 信息 。 
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在 应 用 程序 需求 中 ， 好 友 关 系 并 不 是 双向 的 好 友 关系 ， 而 是 可 能 你 是 我 的 好 友 ， 而 我 并 不 
是 你 的 好 友 ( 现 在 运行 的 几乎 所 有 的 聊天 工具 都 是 这 么 设计 好 友 关系 的 )。 所 以 我 们 不 能 单纯 地 
建立 好 友 关 系 表 ， 要 考虑 单 向 的 好 友 关系 。 在 数据 库 中 ,我 们 就 要 设计 任意 一 方 的 一 对 多 关系 
映射 。 

而 且 ， 在 好 友 关 系 中 ， 并 不 是 单纯 地 建立 起 来 就 行 了 ， 我 们 还 需要 面 对 好 友 请 求 ， 以 及 用 
户 接 不 接受 该 请 求 的 问题 ， 所 以 我 们 要 给 好 友 关 系 添加 一 个 是 否 接受 请 求 的 标识 。 

其 次 ， 消 息 、 文 件 、 好 友 请 求 信息 、 好 友 响 应 信息 ， 这 些 东 西 都 有 一 个 共同 的 结构 ， 即 都 
有 发 送 者 、 接 收 者 ， 并 且 同 属于 一 类 东西 一 一 “信息 ”。 所 以 我 们 可 以 将 这 些 信息 归结 为 一 个 
实体 对 象 ， 使 用 一 个 对 象 属性 来 区 分 不 同 的 消息 类 型 即 可 。 

@ ” 这 样 将 所 有 的 “信息 ” 归 为 一 类 ， 使 用 标识 符 区 分 不 同类 别 的 方法 也 有 利于 以 后 

提示 的 功能 扩展 ， 非 常 方便 。 


在 所 有 “信息 ”对 象 中 ， 消 息 不 仅 有 发 送 者 和 接收 者 ， 还 需要 有 消息 内 容 ; 文件 除了 发 送 
者 和 接收 者 以 及 文件 内 容 外 ， 还 需要 有 一 个 文件 名 ; 而 好 友 请 求 信息 和 好 友 响 应 信息 没有 必要 
具有 信息 内 容 ， 只 需要 区 分 开发 送 者 和 接收 者 就 行 了 。 另 外 ， 为 了 确认 发 送 的 信息 的 时 效 性 ， 
我 们 还 需要 为 “信息 ”对 象 添加 一 个 时 间 戳 。 

因此 ， 我 们 的 整个 应 用 程序 系统 需要 三 个 实体 对 象 : 用 户 、 好 友 关系 和 信息 。 对 于 这 三 个 
实体 对 象 的 具体 属性 ， 我 们 可 以 分 别 做 如 下 设计 。 

@ 用户: 用 户 昵称 (同样 也 是 登录 名 )、 密 码 。 

@ ”好 友 关 系 : 用 户 名 称 、 好 友 名 称 、 是 否 验证 通过 。 

@ ”信息 : 信息 类 型 、 发 送 者 、 接 收 者 、 信 息 内 容 、 发 送 文件 名 (只 对 文件 消息 有 效 )、 发 

送 时 间 戳 。 

对 于 这 三 个 实体 对 象 在 数据 库 中 的 结构 ， 我 们 可 以 进行 简单 的 设计 ， 如 表 14-1 一 表 14-3 

所 示 。 


表 14-1 用 户 表 (Users) 设 计 


字段 名 备 注 
ID 主键 ， 自 增 
Nickname varchar(20) 唯一 约束 
Password varchar(20) 
字段 名 备 注 
ID 主键 ， 自 增 
UserName varchar(20) Users 表 Nickname 字段 外 键 
FriendName varchar(20) Users 表 Nickname 字段 外 键 
IsPass bit 
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表 14-3 信息 表 (Messages) 设 计 


字段 名 
D 编号 
Classify 


备 注 


int 主键 ， 自 增 


Sender Users 表 Nickname 字段 外 键 
Receiver 接收 者 varchar(20) Users 表 Nickname 字段 外 键 
Details 详细 内 容 text 

FileFullName 文件 名 varchar(50) 


发 送 时 间 


datetime 


SendTime 


根据 上 面 的 设计 ， 在 SQL Server 中 创建 数据 库 的 T-SQL 代码 如 下 : 


create table Users 


( 


ID int identity(1,1) primary key, 
Nickname Varchar (20) not null unique, 
Password varchar (20) not null 


create table Friends 

( 
ID int identity(1,1) primary key, 
UserName Varchar (20) foreign key references Users (Nickname), 
FriendName Varchar (20) foreign key references Users (Nickname), 
IsPass bit 


create table Messages 
(! 
ID int identity(1,1) primary key, 
Classify int, 
Sender varchar (20) foreign key references Users (Nickname), 
Receiver varchar (20) foreign key references Users (Nickname), 
Details text, 
FileFullName varchar (50), 
SendTime datetime 
) 


3. 客户 端 界面 设计 


根据 上 面 的 需求 ， 我 们 的 应 用 程序 服务 器 端 使 用 Web 服务 来 提供 相应 的 接口 ， 然 后 在 客 
户 端 调用 Web 服务 来 实现 应 用 程序 的 功能 。 

在 客户 端 ， 使 用 NET 的 Windows 窗 体 应 用 程序 来 创建 用 户 界面 。 要 实现 需求 中 的 所 有 功 
能 ， 需 要 使 用 4 个 Windows 窗 体 来 完成 操作 ， 分 别 是 注册 窗 体 、 登 录 窗 体 、 聊 天 窗 体 和 添加 
好 友 窗 体 。 


< 


注册 窗 体 中 ， 只 需要 接收 用 户 输入 的 用 户 名 和 密码 即 可 。 用 户 密码 非 明文 显示 ， 所 以 需要 
用 户 确认 密码 操作 。 整 个 窗 体 只 需要 3 个 文本 框 接收 用 户 输入 即 可 ， 如 图 14-3 所 示 。 

用 户 登 录 窗 体 是 整个 应 用 程序 运行 中 出 现 的 第 一 个 窗 体 , 也 是 整个 应 用 程序 所 有 功能 的 入 
口 点 。 我们 在 登录 窗 体 中 可 以 打开 注册 窗 体 ， 也 可 以 登录 到 程序 主 界面 。 所 以 登录 窗 体 可 以 设 


计 成 如 图 14-4 所 示 的 效果 。 


图 14-3 用 户 注册 窗 体 图 14-4 用 户 登录 窗 体 


聊天 窗 体 是 整个 应 用 程序 的 主 窗 体 ， 在 这 里 可 以 执行 查看 好 友 列 表 、 刷 新 好 友 列 表 、 发 送 


消息 、 发 送 文件 、 打 开 等 操作 。 设 计 效 果 如 图 14-5 所 示 。 
添加 好 友 窗 体 相对 来 说 非常 简单 ， 只 需要 接收 用 户 输入 的 要 添加 好 友 的 用 户 名 ， 对 其 发 送 


请 求 即 可 。 设 计 效果 如 图 14-6 所 示 。 


EZ 


14-5 ”聊天 窗 体 14-6 ”添加 好 友 窗 体 


4. 特殊 功能 设计 
另外 ， 在 使 用 Web 服务 的 应 用 程序 中 ，Web 服务 器 不 可 能 主动 向 客户 端 发 送信 息 ， 所 以 


我 们 需要 将 信息 暂 存 在 服务 器 中 ， 然 后 等 待 用 户 请 求 。 
而 客户 端正 式 启动 以 后 需要 定时 不 停 地 向 服务 器 发 出 请 求 ， 反 复 地 查询 监听 服务 器 中 的 


消息 。 


14.2 ”服务 器 端 设计 


服务 器 端 需要 集中 执行 用 户 注册 、 验 证 用 户 存在 、 用 户 登录 、 添 加 好 友 、 处 理 好 友 请 求 、 
发 送 消息 、 发 送 文件 、 监 听信 息 、 查 询 好 友 列 表 等 功能 。 


mf >> 
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14.2.1 创建 项 目 结构 


这 里 我 们 使 用 Web 服务 实现 在 互联 网 中 发 布 的 功能 , 所 以 需要 使 用 一 个 ASPNET Web 服 
务 项 目 。 

当然 我 们 这 里 需要 操作 数据 库 ,并 且 需 要 处 理 一 些 业务 逻辑 ， 所 以 使 用 三 层 架构 的 模式 来 
设计 项 目 。 

首先 创建 一 个 解决 方案 ， 命 名 为 WebServiceApp; 在 解决 方案 中 创建 一 个 用 于 发 布 Web 
服务 的 Web 项 目 , 也 命名 为 WebServiceApp; 然后 再 创建 一 个 用 于 封装 数据 访问 操作 的 类 库 项 
目 ， 命 名 为 Web.DAL; 最 后 创建 一 个 用 于 封装 业务 逻辑 的 类 库 项 目 ， 命 名 为 Web.BLL。 

上 面 所 有 的 工作 执行 完 以 后 ，Visual Studio 中 的 解决 方案 资源 管理 器 中 的 效果 如 图 14-7 
所 示 。 


解 岂 方案 资源 各 理 器 
号 |3 回 | 日 日 把 IB 


辐 解 决 方案 WebserviceApp”(3 个 项 目 ) 
甸 六 rs 


田 国 re DL 
加 el ie 


窜 怕人 ba lt) minE 
图 14-7 解决 方案 资源 管理 器 


完成 以 后 我 们 还 要 为 这 三 个 项 目 创建 引用 关系 。 这 三 个 项 目的 引用 关系 为 Web.BLL 引用 
Web.DAL，WebServiceApp 引用 Web.BLL 和 Web.DAL。 


14.2.2 ”添加 数据 访问 类 


因为 使 用 的 是 SQL Server 数据 库 ， 所 以 在 项 目 中 使 用 LINQ to SQL 来 执行 数据 库 操 作 是 
非常 方便 的 事情 。 

这 里 我 们 在 Visual Studio 的 Web.DAL 项 目 中 添加 一 个 LINQ to SQL 类 ， 命 名 为 
DataMessage。 创 建 以 后 打开 这 个 类 。 

然后 在 “服务 器 资源 管理 器 ”中 添加 到 实例 数据 库 的 连接 ， 并 浏览 该 数据 库 中 的 表 。 


全 。 这 里 需要 首先 创建 一 个 数据 库 ， 并 使 用 前 面 的 创建 数据 库 表 的 代码 创建 需要 的 数 
注意 | 。 据 库 表 。 


在 “服务 器 资源 管理 器 ”中 选中 数据 库 表 Friends、Messages 和 Users， 并 用 鼠标 将 其 拖 入 
创建 的 LINQ to SQL 类 DataMessage 中 。 执 行 结果 如 图 14-8 所 示 。 

通常 来 说 ， 这 里 创建 完成 以 后 ， 就 可 以 正常 使 用 了 。 但 是 ， 由 于 LINQ to SQL 类 自动 创 
建 的 模型 对 象 会 根据 表 之 间 的 关联 创建 相互 的 引用 关系 ， 这 在 使 用 XML 序列 化 数据 对 象 的 时 
候 就 会 造成 无 限 循环 的 引用 。 所 以 我 们 要 进行 一 些 设 置 ， 避 免 这 种 问题 。 

首先 在 DataMessage 类 的 属性 窗口 中 设置 序列 化 模式 为 “ 单 向 ”， 如 图 14-9 所 示 。 
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14-8 DataMessage 类 图 14-9 设置 序列 化 模式 
然后 ， 分 别 设置 每 一 个 关联 关系 的 父 属性 的 访问 权限 为 nternal， 如 图 14-10 所 示 。 


图 14-10 设置 关联 关系 的 父 属性 的 访问 权限 


14.2.3 ”验证 用 户 是 否 存 在 


首先 需要 在 Web.BLL 项 目 中 创建 一 个 封装 业务 逻辑 的 类 ， 命 名 为 MessageManager。 然 后 
在 MessageManager 类 文件 中 添加 对 Web.DAL 项 目的 引用 。 

下 面 我 们 在 MessageManager 类 中 添加 一 个 验证 用 户 是 否 存 在 的 方法 ， 名 为 Exist， 实 现代 
码 如 下 : 


mT >> 
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// 验 证 用 户 是 否 存在 


public bool Exist(string nickname) 
// 创 建 一 个 数据 环境 对 象 


DataMessageDataContext dm = new DataMessageDataContext () 7 


// 统 计 Users 表 中 符合 条 件 的 对 象 的 数目 


int num = dm.Users.Count (u => u.Nickname == nickname) 7 


// 如 果 查 询 得 到 的 数目 大 于 0， 说 明 该 用 户 存在 


bool exist = num > 07 


return exist; 


} 


然后 ， 需 要 在 Web 项 目 WebServiceApp 中 创建 一 个 Web 服务 ， 用 于 向 Internet 中 发 布 。 
该 Web 服务 命名 为 WSMessage。 
同样 需要 在 Web 服务 WSMessage 中 添加 用 于 验证 用 户 是 否 存在 的 Web 方法 ， 具 体 实现 
代码 如 下 所 示 : 
// 验 证 用 户 是 否 存在 
[WebMethod] 
public bool HaveUser (string nickname) 
# 
MessageManager mm = new MessageManager () 7 
bool exist = mm.Exist (nickname); 
return exist; 


14.2.4 用 户 注 册 功 能 


首先 需要 在 Web.BLL 项 目 中 的 MessageManager 类 中 添加 执行 注册 功能 的 代码 , 具体 要 求 
代码 如 下 : 
// 执 行 注册 功能 


public bool Register (Users user) 
{ 
// 创 建 一 个 数据 环境 对 象 


DataMessageDataContext dm = new DataMessageDataContext () 7 


try 

| 
dm.Users.InsertOnSsubmit (user); 
dm.SubmitChanges (); 

} 


catch 


{ 


< 人 mm 


return false; 
} 
return true; 


} 
然后 在 Web 服务 WSMessage 中 添加 发 布 注 册 功 能 的 Web 方法 ， 具 体 实现 代码 如 下 : 


// 注 册 
[WebMethod] 
public bool Register (string nickname, string password) 
{ 
MessageManager mm = new MessageManager (); 
Users user = new Users() 
{ 
Nickname = nickname, 
Password = password 
}; 


return mm.Register (user); 


14.2.5 用 户 登录 功能 


首先 需要 在 MessageManager 中 添加 执行 登录 验证 功能 的 代码 ， 用 于 根据 用 户 名 和 密码 返 


回 一 个 用 户 对 象 。 如 果 返 回 为 空 ， 即 登录 不 成 功 。 有 具体 实现 代码 如 下 : 


= -> 


// 执 行 登录 功能 


public Users Login (string nickname, string password) 


{ 
// 创 建 一 个 数据 环境 对 象 
DataMessageDataContext dm = new DataMessageDataContext () 7 
try 
{ 
// 查 询 得 到 指定 用 户 
Users user = dm.Users.Single(u => u.Nickname == nickname); 
return user; 
} 
catch 
| 
return null; 
| 
册 


同样 在 Web 服务 WSMessage 中 添加 验证 用 户 登 录 的 Web 方法 ， 具 体 代码 如 下 : 
// 验 证 登录 


[WebMethod (EnableSession = true)] 
public bool Login (string nickname, string password) 
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MessageManager mm = new MessageManager (); 
Users user = mm.Login (nickname, password); 


// 状 态 保持 
Session["CurrentUser"] = user; 
return user != null; 


14.2.6 ”添加 好 友 功 能 


首先 ， 在 MessageManager 类 中 加 入 用 于 添加 好 友 功 能 的 业务 逻辑 代码 。 这 里 我 们 需要 过 
滤 用 户 的 多 次 请 求 ， 如 果 某 个 用 户 向 指定 的 用 户 发 送 多 次 好 友 请 求 ， 服 务 器 只 记录 一 次 。 执 行 
该 操作 的 时 候 需要 同时 向 消息 表 和 好 友信 息 表 中 写 入 数据 库 。 有 具体 实现 代码 如 下 : 

// 添 加 好 友 


public void AddFriend (Messages msg) 
{ 
// 创 建 一 个 数据 环境 对 象 
DataMessageDataContext dm = new DataMessageDataContext () 7 
// 查 询 用 户 是 否 已 经 是 好 友 或 好 友 请 求 已 经 发 送 成 功 
var fs = (from f in dm.Friends 
where f.UserName == msg.Sender && f.FriendName == msg.Receiver 
select f) .ToList()7 

// 如 果 查 询 到 相关 信息 ， 就 不 再 执行 该 操作 
if (fs != null && fs.Count > 0) 
{ 

return; 
1 
Friends friend = new Friends () 
{ 

UserName = msg.Sender, 

FriendName = msg.Receiver, 

IsPass = false 
}; 
dm.Messages.InsertOonsubmit (msg); 
dm.Friends.InsertOonsubmit (friend); 
dm.SubmitChanges (); 


同样 需要 在 Web 服务 WSMessage 中 添加 相应 的 处 理 代码 ， 具 体 代 码 如 下 : 
// 添 加 好 友 


[WebMethod (EnableSession = true)] 

public void AddFriend(string nickname) 

{ 
Users user = Session["CurrentUser"] as Users; 
if (user == null) 
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throw new Exception(" 用 户 尚未 登录 ! ") 7 
1 


Messages msg = new Messages ()7 
msg.Classify = 37 

msg.Receiver = nickname; 

msg.SendTime = DateTime.Now; 

msg.Sender = user.Nickname; 
MessageManager mm = new MessageManager (); 
mm.AddFriend (msg); 


14.2.7 ”处 理 好 友 请 求 


户 接受 到 好 友 请 求 以 后 ， 需 要 对 好 友 请 求 进行 处 理 。 我 们 可 以 接受 请 求 或 者 拒绝 请 求 ， 
这 两 个 操作 的 执行 方式 不 同 : 在 同意 请 求 的 时 候 需 要 修改 好 友信 息 的 状态 ; 在 拒绝 请 求 的 时 候 
需要 删除 请 求 信息 。 所 以 需要 在 MessageManager 中 分 别 添加 接受 和 拒绝 操作 的 代码 ， 具 体 代 
码 如 下 : 

/ /同意 好 友 请 求 


public void AgreeFriend (Messages msg) 


{ 


/ /创建 一 个 数据 环境 对 象 
DataMessageDataContext dm = new DataMessageDataContext () 7 
Friends friend = dm.Friends.Single(E => 


f.IsPass == false && 
f.UserName == msg.Receiver && 
f.FriendName == msg.Sender); 


friend.IsPass = true; 
dm.Messages.InsertOnSubmit (msg); 
dm.SubmitCchanges () 7 

} 

// 拒 绝 好 友 请 求 

public void RejectFriend (Messages msg) 

{ 
// 创 建 一 个 数据 环境 对 象 
DataMessageDataContext dm = new DataMessageDataContext () 7 
Friends friend = dm.Friends.Single(E => 


f.IsPass == false && 
f.UserName == msg.Receiver && 
f.FriendName == msg.Sender); 


dm.Friends.DeleteOonsubmit (friend); 
dm.Messages.InsertOonsubmit (msg); 
dm.SubmitChanges (); 
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然后 ， 还 需要 在 Web 服务 WSMessage 中 添加 处 理 好 友 请 求 的 Web 方法 ， 有 具体 代码 如 下 : 
// 处 理 好 友 请 求 


[WebMethod (EnableSession = true)] 
public void HandleFriendRequest (bool accept,string friend) 
. 

Users user = Session["CurrentUser"] as Users; 

if (user = null) 

1 

throw new Exception ("用 户 尚未 登录 ! "); 

} 

Messages msg = new Messages(); 

msg.Classify = accept ? 4 : 57 

msg.Receiver = friend; 

msg.SendTime = DateTime.Now; 

msg.Sender = user.Nickname; 

MessageManager mm = new MessageManager (); 

if (accept) 

1 

mm.AgreeFriend (msg); 

} 

else 

{ 


mm.RejectFriend (msg); 


14.2.8 ”发 送 消息 功能 


首先 ， 需 要 在 MessageManager 类 中 添加 发 送 消 息 功 能 的 方法 ， 用 于 向 数据 库 中 保存 一 条 
消息 ， 具 体 代 码 如 下 : 
// 发 送信 息 


public void SendMessage (Messages msg) 
{ 
if (msg.Classify == 3) 


| 
AddFriend (msg); 
} 
else if (msg.Classify == 4) 
{ 
AgreeFriend (msg); 
| 
else if (msg-Classify == 5) 
{ 
RejectFriend (msg) > 
上 


// 创 建 一 个 数据 环境 对 象 


< 
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} 


DataMessageDataContext dm = new DataMessageDataContext () 7 
dm.Messages.InsertOonSubmit (msg); 
dm.SubmitChanges(); 


然后 需要 在 Web 服务 WSMessage 中 添加 相应 的 发 送 消 息 功能 的 Web 方法 ， 具 体 代码 
如 下 : 
// 发 送 消息 


[WebMethod (EnableSession = true)] 
public void SendMessage (Messages msg) 


{ 


Users user = Session["CurrentUser"] as Users; 
if (user == null) 
{ 
throw new Exception ("用 户 尚未 登录 ! "); 
} 
msg.Classify 1; 
msg.SendTime = DateTime .Now; 
msg.Sender = user.Nickname; 
MessageManager mm = new MessageManager (); 


mm.SendMessage (msg); 


14.2.9 ”发 送 文件 功能 


因为 在 服务 器 端 ， 文件 信息 对 象 和 普通 消息 对 象 的 执行 操作 相同 ， 所 以 这 里 可 以 使 用 
MessageManager 类 中 发 送 消息 的 方法 来 执行 发 送 文 件 操作 。 

但 是 在 Web 服务 WSMessage 中 还 要 创建 一 个 Web 方法 ， 具 体 代码 如 下 : 

// 发 送 文件 


[WebMethod (EnableSession = true)] 
public void SendFile (Messages msg) 


Ed 人 > 


{ 


Users user = Session["CurrentUser"] as Users; 
if (user == null) 
{ 
throw new Exception ("用户 尚未 登录 ! "); 
} 
msg-Classify 27 
msg.SendTime = DateTime.Now; 
msg.Sender = user.Nickname; 


ll 


MessageManager mm = new MessageManager () 7 


mm.SendMessage (msg); 
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14.2.10 ”监听 信息 功能 


首先 我 们 需要 在 MessageManager 类 中 添加 查询 指定 用 户 消息 的 方法 ， 具 体 代码 如 下 : 
// 获 取信 息 列 表 


public List<Messages> GetMessages (string nickname) 
{ 
// 创 建 一 个 数据 环境 对 象 
DataMessageDataContext dm = new DataMessageDataContext () 7 
// 查 询 得 到 符合 条 件 的 结果 集 
Var ms = from m in dm.Messages 
where m.Receiver == nickname 
select m; 
// 将 结果 集 转换 成 List 
List<Messages> messages = ms.ToList(); 
// 为 了 不 让 下 面 的 删除 操作 影响 查询 结果 集 ， 我 们 在 这 里 把 该 结果 集 复制 一 份 
messages = CopyMessageList (messages) 7 
// 删 除数 据 库 中 已 被 用 户 获取 过 的 结果 集 
dm.Messages.DeleteAllonsubmit (ms) 7 
dm.SubmitCchanges () 7 
// 返 回 结果 
return messages; 


} 


因为 需要 同时 执行 查询 和 删除 操作 ， 删 除 操作 可 能 会 影响 查询 操作 的 结果 ,我 们 在 执行 删 
除 操作 以 前 需要 将 查询 结果 复制 到 一 个 集合 中 ， 以 备 使 用 。 所 以 这 里 还 需要 一 个 复制 查询 结果 
集 的 私有 方法 ， 具 体 代 码 如 下 : 


//copy 信息 列表 
private List<Messages> CopyMessageList (List<Messages> msgs) 
List<Messages> messages = new List<Messages>(); 
foreach (var m in msgs) 
| 
Messages msg = new Messages (); 
msg.ID = m.ID; 
msg.Classify = m.Classify; 
msg.Details = m.Details; 
msg.FileFullName = m.FileFullName; 
msg.Receiver = m.Receiver; 
msg.Sender = m.Sender; 
msg.SendTime = m.SendTime; 
messages.Add (msg); 
i 


return messages; 
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然后 , 还 要 在 Web 服务 WSMessage 中 添加 一 个 执行 监听 功能 的 Web 方法 , 具体 代码 如 下 : 
// 监 听信 息 


[WebMethod (EnableSession = true)] 
public List<Messages> Monitor () 
Users user = Session["CurrentUser"] as Users; 
if (user == null) 
{ 
throw new Exception ("用 户 尚未 登录 ! "); 
让 
MessageManager mm = new MessageManager () 7 
Var ms = mm.GetMessages (user.Nickname); 
return ms; 


14.2.11 获取 好 友 列 表 功 能 


首先 ， 需 要 在 MessageManager 类 中 添加 一 个 获取 指定 用 户 好 友 列 表 的 方法 ， 有 具体 代码 
如 下 : 


// 获 取 指定 用 户 的 好 友 列表 
public List<Friends> GetFriendList (string nickname) 
{ 
// 创 建 一 个 数据 环境 对 象 
DataMessageDataContext dm = new DataMessageDataContext () 7 
var fs = from f in dm.Friends 
where f.UserName == nickname && f.IsPass == true 
Selcce En 
return fs.ToList(); 


} 


接 下 来 还 要 在 Web 服务 WSMessage 中 添加 一 个 查询 用 户 好 友 列 表 的 Web 方法 ， 有 具体 代 
码 如 下 : 


// 获 取 好 友 列 表 
[WebMethod (EnableSession = true)] 
public List<Friends> GetFriendList() 
{ 
Users user = Session["CurrentUser"] as Users; 
if (user == null) 
1 
throw new Exception(" 用 户 尚未 登录 ! ") 


MessageManager mm = new MessageManager () 7 
return mm.GetFriendList (user.Nickname); 
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14.3 ”客户 端 设计 


在 前 面 我 们 也 都 看 到 了 ， 该 项 目的 客户 端 使 用 的 是 Windows 窗 体 应 用 程序 ， 并 且 在 客户 
端 一 共有 4 个 应 用 程序 窗 体 ， 分 别 是 注册 窗 体 FormRegister、 登 录 窗 体 FormLogin、 好 友 查 找 
窗 体 FormFindFriend 和 聊天 主 窗 体 FormMessage。 

客户 端 需要 在 服务 器 端 保存 用 户 的 状态 ， 所 以 需要 在 客户 端 添加 对 Web 服务 项 目的 Web 
引用 。 引 用 的 命名 空间 名 称 为 WebServiceMessage。 


14.3.1 注册 窗 体 功 能 设计 


前 面 也 看 过 注册 窗 体 的 设计 界面 ， 现 在 为 其 添加 实现 程序 。 
窗 体 只 实现 “注册 用 户 ” 的 功能 。 具 体 实现 方式 是 在 用 户 单 击 注册 按钮 时 ， 获 取 表 单 上 用 
户 输入 的 信息 ， 进 行 一 些 简 单 的 验证 ， 然 后 调用 Web 服务 方法 执行 注册 功能 ， 注 册 成 功 时 关 
闭 当 前 窗 体 。 具 体 实现 代码 如 下 : 
private void btnsubmit Click(object sender, EventArgs e) 
{ 
string nickname this.txtNickname.Text.Trim(); 
string password this.txtPassword.Text.Trim(); 
string rePassword = this.txtRePassword.Text.Trim(); 
// 用 户 名 不 能 为 空 
if (nickname == string.Empty) 


{ 


MessageBox.Show("" 用 户 名 "不 能 为 空 ! ") ; 


return; 


} 

// 密 码 不 能 为 空 

if (password == string.Empty) 

{ 
MessageBox .Show ("" 密 码 " 不 能 为 空 ! "); 
return; 

1 

// 两 次 密码 必须 一 致 

if (password != rePassword) 

{ 
MessageBox.Show ("两 次 密码 不 一 致 ! "); 


return; 


} 
// 禁 用 提交 按钮 


this.btnsubmit.Enabled = false; 
// 创 建 一 个 代理 类 对 象 


WebServiceMessage.WSMessage wsm = new WebServiceMessage-WSMessage () 7 
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// 验 证 用 户 是 否 存在 


bool isExist = wsm.HaveUser (nickname); 


if (isExist) 


{ 
MessageBox .Show ("该 用 户 名 已 存在 ， 请 换个 用 户 名 再 试 ! ") ; 
this.btnsubmit.Enabled = true; 
return; 

} 

// 获 取 执 行 结果 


bool over = wsm.Register (nickname, password); 
// 如 果 执 行 成 功 ， 提 示 并 关闭 注册 对 话 框 
// 如 果 执 行 失败 ， 提 示 并 让 用 户 重 试 


if (over) 


{ 


} 


MessageBox.Show ("注册 成 功 ! "); 
this.Close(); 


else 


{ 


MessageBox.Show ("注册 失败 ， 请 重 试 。"); 
this.btnSubmit.Enabled = true; 


14.3.2 ”登录 窗 体 功能 设计 


登录 窗 体 是 应 用 程序 运行 时 出 现 的 第 一 个 窗 体 。 但 是 因为 其 不 是 主要 功能 ， 所 以 不 能 把 它 


当做 应 用 程序 启动 的 默认 窗 体 。 


这 里 将 登录 窗 体 在 应 用 程序 默认 窗 体 的 构造 方法 中 打开 ， 这样 虽然 它 不 是 主 窗 体 ,但 是 却 


可 以 作为 第 一 个 窗 体 打开 。 


但 是 如 果 在 登录 窗 体 中 ,用 户 不 执行 登录 操作 而 直接 关闭 该 窗 体 ， 应 用 程序 也 理应 正常 关 
闭 。 而 如 果 用 户 登 录 成 功 ， 系 统 则 关闭 登录 窗 体 并 同时 打开 聊天 主 窗 体 。 所 以 ， 应 用 程序 要 添 


加 对 关闭 操作 时 的 设计 。 代 码 如 下 : 


public partial class FormLogin : Form 


{ 


private FormMessage master = null; 
private bool CloseKey = true; 
public FormMessage Master 


1 


Private void FormLogin FormClosing (object sender, FormClosingEventArgs e) 


| 


get { return master; } 


set { master = value; } 


if (CloseKey) 


} 


这 是 


Application.Exit(); 


} 


// 其 他 代码 省 略 
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有 添加 了 一 个 主 窗 体 的 类 属性 , 以 便 登 录 窗 体 在 登录 成 功 以 后 能 够 对 主 窗 体 进行 一 些 简 


单 的 设置 。 而 且 在 登录 窗 体 中 还 添加 了 一 个 名 为 CloseKey 的 属性 ， 是 为 了 区 别 在 登录 窗 体 关 
闭 时 ， 是 直接 关闭 还 是 登录 成 功 关闭 ， 以 便 执行 一 些 相 应 的 操作 。 


打 姑 


当然 ， 在 登录 窗 体 中 还 有 一 个 【登录 】 按 钮 和 一 个 【注册 】 按 钮 。 
F 注 册 窗 口 来 让 用 户 执行 注册 操作 ;登录 操作 是 执行 用 户 的 验证 和 登录 功能 。 


其 中 【注册 】 按 钮 的 单 击 事件 处 理 程序 如 下 


private void btnRegister Clickl(object sender, EventArgs e) 


{ 


} 


// 创 建 一 个 注册 窗口 
FormRegister fr = new FormRegister(); 
// 以 对 话 框 的 形式 打开 该 窗口 


fr.ShowDialog(); 


【登录 】 按 钮 的 单 击 事件 处 理 程序 如 下 : 


private void btnLogin Click(object sender, EventArgs e) 


this.txtUsername.Text.Trim(); 
this.txtPassword.Text.Trim(); 


string nickname 
string password 


// 用 户 名 不 能 为 空 

if (nickname == string.Empty) 

{ 
MessageBox.Show("" 用 户 名 "不 能 为 空 ! ") ; 
return; 

} 

// 密 码 不 能 为 空 

if (password == string.Empty) 


{ 
MessageBox.Show("" 密 码 "不 能 为 空 ! "); 
return; 


} 


【注册 】 按 钮 只 是 为 了 


WebServiceMessage.WSMessage wsm = new WebServiceMessage.WSMessage(); 


// 创 建 一 个 cookie 容器 ， 用 于 保存 用 户 会 话 状态 
CookieContainer cookies = new CookieContainer(); 
// 向 主 窗 体 传递 Web 服务 代理 对 象 ， 以 重复 使 用 
this.Master.WsMessage = WSm7 
wsm.CookieContainer = cookies; 

bool over = wsm.Login (nickname, password); 


if (over) 
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14.3.3 


this.Master.CurrentUsername = nickname; 
this.CloseKey = false; 
// 关 闭 登 录 框 
this.Close(); 

} 

elLSe 

| 
MessageBox.Show ("登录 失败 ， 请 重 试 ! "); 
this.btnLogin.Enabled = true; 
this.btnRegister.Enabled = true; 


添加 好 友 窗 体 功能 设计 


添加 好 友 窗 体 功能 非常 简单 ， 只 需要 用 户 输入 一 个 用 户 名 ， 然 后 单 击 【发 送 请 求 】 按 钮 ， 
即 可 向 服务 器 发 送 相应 的 好 友 请 求 信息 。 

在 该 窗 体 中 使 用 了 一 个 代理 类 对 象 ， 这 里 我 们 为 添加 好 友 窗 体 类 添加 一 个 类 属性 ， 用 于 得 
到 登录 窗 体 传递 的 代理 类 对 象 。 

在 用 户 单 击 【发 送 请 求 】 按 钮 时 ， 需 要 验证 用 户 是 否 存在 ， 如 果 系 统 中 不 存在 该 用 户 ， 提 
示 用 户 并 取消 操作 。 而 且 还 需要 验证 , 如 果 用 户 已 经 是 我 们 的 好 友 , 那么 将 不 能 添加 这 个 用 户 ， 
并 提示 该 用 户 已 经 存在 于 好 友 列 表 。 最 后 请 求 发 送 成 功 以 后 ， 关 闭 该 窗 体 。 

下 面 来 看 一 下 【发 送 请 求 】 按 钮 的 单 击 事件 处 理 程序 代码 : 


private void btnRequest Click(object sender, EventArgs e) 


{ 


string username = this.txtUsername.Text.Trim(); 
// 验 证 输入 的 用 户 名 不 能 为 空 
if (username == null || username == string.Empty) 
{ 
MessageBox .Show ("请 输入 要 请 求 的 用 户 名 称 。") ; 
return; 


1 


// 判 断 用 户 是 否 存在 
bool isExist = WsMessage.HaveUser (username); 
if (!isExist) 
{ 
MessageBox.Show ("用 户 不 存在 ! "); 
return; 
} 
WebServiceMessage.Friends[] friends = WsMessage.GetFriendList(); 
foreach (var f in friends) 
| 


if (username == f.FriendName) 
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MessageBox.Show ("该 用 户 已 经 是 你 的 好 友 ! "); 
return; 
} 
} 
// 添 加 好 友 


WsMessage.AddFriend (username); 


this.Close(); 


14.3.4 ”聊天 窗 体 功能 设计 


在 聊天 主 窗 体 中 主要 执行 五 个 操作 : 刷新 好 友 列 表 、 添 加 好 友 、 发 送 文 件 、 发 送 消息 以 及 
监听 信息 等 。 

该 窗 体 类 需要 使 用 一 个 已 登录 过 的 Web 服务 代理 对 象 和 一 个 登录 过 的 用 户 名 ， 所 以 需要 
在 该 类 中 添加 两 个 类 属性 ， 代 码 如 下 : 

public partial class FormMessage : Form 

, WebServiceMessage.WSMessage wsMessage = null; 


private string currentUsername = null; 
#region Public Attribute 


public WebServiceMessage.WSMessage WsMessage 
{ 

get { return wsMessage; } 

set { wsMessage = value; } 
} 


public string CurrentUsername 


{ 
get { return currentUsername; } 
set { currentUsername = value; } 
} 
#endregion 
// 其 他 代码 省 略 


} 


聊天 窗 体 是 应 用 程序 的 主 窗 体 ， 所 以 需要 在 应 用 程序 入 口 点 Main 方法 中 修改 由 该 窗 体 启 
动 应 用 程序 。 客 户 端 Program 类 中 Main 方法 的 代码 如 下 : 
[SsTAThread] 


static void Main() 


{ 


Application.EnableVisualstyles(); 
Application.SetCompatibleTextRenderingDefault (false); 
Application.Run (new FormMessage()); 


< 人 mm 


系统 启动 的 时 候 会 自动 调用 该 窗 体 的 构造 方法 ,执行 初始 化 操作 。 这 里 我 们 在 构造 方法 中 
添加 相应 的 初始 化 代码 ， 如 下 所 示 : 


public FormMessage() 

InitializeComponent (); 

if (WsMessage == null) 

{ 
FormLogin login = new FormLogin(); 
login.Master = this; 
login.ShowDialog(); 
if (CurrentUsername == null || WsMessage == null) 
{ 

return; 

} 
this.Text += " (当前 用 户 : " + this.CurrentUsername + ")"; 
// 初 始 化 好 友 列表 


this.RefreshFriendList(); 


WsMessage.Timeout = -1; 
// 开 始 监听 


this.timerMonitor.Start() 7 


》 这 里 最 后 一 行 代码 this.timerMonitor.Start() 是 使 用 窗 体 中 的 一 个 Timer 控件 来 启动 
至 去 | ”监听 程序 。 对 于 该 控件 的 功能 ， 稍 后 我 们 再 来 讲解 。 初 始 化 好 友 列 表 的 方法 
this.RefreshFriendList0 的 代码 也 稍 后 再 来 讲解 。 
应 用 程序 主 窗 体 初始 化 完毕 ， 就 可 以 编写 代码 为 其 添加 相应 的 功能 处 理 方法 了 。 
1. 刷新 好 友 列 表 
刷新 好 友 列 表 功 能 是 在 单 击 窗 体 中 的 【刷新 】 按 钮 时 执行 的 一 个 方法 。 另 外 窗 体 初 始 化 、 
添加 好 友 成 功 以 后 也 需要 刷新 好 友 列 表 ， 所 以 我 们 把 它 保存 成 一 个 独立 的 方法 。 
【刷新 】 按 钮 的 单 击 事件 和 刷新 好 友 列 表 方 法 的 代码 如 下 所 示 : 


private void btnRefresh Click(object sender, EventArgs el) 


{ 
// 刷 新 好 友 列 表 


this.RefreshFriendList(); 


} 

// 刷 新 好 友 列表 

private void RefreshFriendList() 

{ 
// 清 空 好 友 列 表 
this.lstUsers.Items.Clear(); 
// 请 求 获 得 好 友 列 表 


WebServiceMessage.Friends[] friends = WsMessage.GetFriendList(); 


这 是 
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// 遍 历 添加 用 户 列表 


foreach (var f in friends) 


1 
this.lstUsers.Items.Add(f.FriendName); 


添加 好 友 


pri 


{ 


} 


3: 


的 添加 好 友 操 作 只 需要 打开 “添加 好 友 ” 对 话 框 ( 窗 体 ) 即 可 ， 具 体 代 码 如 下 : 
Vate void btnSearch Click(object sender, EventArgs e) 
FormFindFriend fff = new FormFindFriend(); 


fff.WsMessage = this.WsMessage; 
fff.ShowDialog(); 


发 送 消息 


发 送 消息 功能 非常 简单 。 我 们 只 需要 把 文本 框 中 的 内 容 封 装 成 一 个 Messages 对 象 ， 调 用 
Web 方法 执行 发 送 操作 ， 并 将 消息 添加 到 消息 列表 中 ， 清 空 消 息 框 即 可 。 具 体 实现 代码 如 下 : 


pri 


{ 


vate void btnsend _ Click(object sender, EventArgs e) 


string content = this.txtMessage.Text.Trim(); 
object target = this.lstUsers.SelectedItem; 
if (content == string.Empty) 
{ 
return; 
} 
if (target == null) 
| 
MessageBox .Show ("请 选择 好 友 ! "); 
return; 


WebServiceMessage.Messages msg = new WebServiceMessage.Messages (); 
msg.Classify = 1; 

msg.Details = content; 

msg.Receiver = target.ToString(); 

WsMessage.SendMessage (msg); 

// 将 发 送 的 消息 加 入 列表 

string message = "我 对 " + msg.Receiver + " 说 ; \r\n " + msg.Details; 
this.AddMessageToList (message); 

// 清 空 文本 框 


this.txtMessage.Text = string.Empty; 


< 和 


这 和 


有 用 到 了 一 个 AddMessageToList0 方 法 ， 用 于 将 一 个 文本 消息 添加 到 窗 体 中 的 消息 列表 


中 ， 实 现代 码 如 下 : 
// 将 消息 加 入 列表 


pri 


和 


} 


4. 


vate void AddMessageToList (string msg) 


this.txtMessages.Text += msg7 
this.txtMessages.Text += "\r\n\r\n"™; 


发 送 文件 


发 送 文件 操作 需要 让 用 户 选 择 一 个 文件 ， 并 将 用 户 选 定 的 文件 转换 成 一 个 字 节 数组 ， 然 后 
将 该 字 节 数组 转换 成 一 个 字符 串 对 象 ， 使 用 该 字符 串 对 象 作为 Messages 对 象 的 消息 内 容 封装 ， 
调用 Web 方法 进行 提交 。 具 体 代码 如 下 : 


pri 


{ 


Vate void btnsendFile Click(object sender, EventArgs e) 


object target = this.lstUsers.SelectedItem; 
if (target == null) 
{ 
MessageBox .Show ("请 选择 好 友 ! "); 
return; 
} 
OpenFileDialog ofd = new OpenFileDialog(); 
ofd.SshowDialog(); 
string filename = ofd.FileName; 


// 如 果 用 户 没有 选择 文件 ， 不 执行 操作 


if (filename == null || filename.Trim() == string.Empty) 
{ 
return; 
} 
// 限 制 发 送 文件 的 大 小 


FileInfo file = new FileInfo (filename); 
long fileLength = file.Length; 
// 如 果 发 送 的 文件 大 于 300KB， 拒 绝 发 送 (文件 过 大 会 降低 应 用 程序 性 能 ) 
if ((fileLength / 1024) > 10) 
{ 
MessageBox .Show ("系统 暂时 不 支持 发 送 大 于 10KB 的 文件 ， 请 重新 选择 文件 。") ; 


return; 


| 

// 确 认 发 送 文件 

DialogResult result = MessageBox.Show( 
"是 否 发 送 文件 ，\r\n" + filename + "\r\n 大 小 : " + (fileLength / 1024) + "Kny 
"确认 发 送 "， MessageBoxButtons.YesNo); 

if (result == DialogResult.No) 

1 
return; 


} 


} 
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// 发 送 文件 


this.SendFile(filename, target.ToString()); 


// 发 送 文件 


private void SendFilel(string filename, string target) 


:i 


外 


// 创 建 一 个 文件 流 对 象 ， 并 初始 化 

FileStream fs = new Filestream(filename, FileMode.Open); 

// 创 建 一 个 二 进 制 数组 

byte[] bs = new byte[fs.Length]7 

// 从 文件 流 中 读 取 内 容 

fs.Read(bs, 0, bs.Length); 

// 关 闭 流 

fs.Close(); 

// 初 始 化 Messages 对 象 

WebServiceMessage.Messages msg = new WebServiceMessage.Messages(); 
msg.Classify = 27 

msg.Details = ConvertstringAndBytes.ConvertBytesToString (bs); 
msg.Receiver = target; 

msg.FileFullName = filename.Substring (filename.LastIndexOf ("\\") + 1); 
// 执 行 发 送 操作 


WsMessage.SendFile (msg); 


这 里 为 了 防止 发 送 文件 太 大 浪费 系统 性 能 ， 限 制 用 户 发 送 的 文件 大 小 不 得 超过 
10KB. 


当然 这 里 用 到 了 一 个 执行 字符 串 和 二 进 制 数组 转换 功能 的 静态 方法 类 ConvertString 
AndBytes， 该 类 代码 如 下 : 


public class ConvertstringAndBytes 


{ 


// 将 字 节 数组 转换 为 十 六 进 制 字符 串 
public static string ConvertBytesToString(byte[] bs) 
:| 
string str = string.Empty; 
if (bs != nul1l) 
{ 
StringBuilder sb = new StringBuilder(); 
for (int i = 0; i < bs.Length; i++) 
{ 
sb.Append (bs [i] .ToString("X2") ) 7 
1 
str = sb.Tostring(); 
} 
return str; 
} 
// 将 十 六 进 制 符号 字符 串 转 换 为 字 节 数组 


public static byte[] ConvertStringToBytes (string str) 


< 计 一 _ 
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byte[] bs = new byte[str-Length / 2]; 
for (int i = 0; i < bs.Length; i++) 
i 
bs[i] = Convert.ToByte(str.Substring(i * 2, 2), 16); 
} 
return bs; 


5. 监听 信息 


因为 服务 器 端 只 接收 客户 端的 请 求 ， 不 能 主动 向 客户 端 发 送 最 新 消息 内 容 ， 所 以 为 了 使 客 
户 端 及 时 获取 最 新 的 消息 ， 需 要 不 停 地 对 服务 器 端的 消息 状态 进行 监听 。 所 以 我 们 在 聊天 窗 体 
中 添加 了 一 个 监听 控件 timerMonitor， 使 该 控件 每 阳 2 秒 钟 向 服务 器 发 出 一 次 请 求 ， 查 询 用 户 
的 最 新 状态 信息 。 

在 聊天 窗 体 的 构造 方法 中 ,我 们 已 经 启动 了 监听 控件 的 监听 操作 ， 下 面 来 看 看 监听 控件 的 
事件 处 理 程序 ， 具 体 代 码 如 下 


private void timerMonitor Tick(object sender, EventArgs el) 
{ 
// 获 取消 息 列表 
WebServiceMessage.Messages[] msgs = WsMessage.Monitor(); 
// 遍 历 处 理 消息 列表 
foreach (var m in msgs) 
{ 
// 根 据 消息 类 型 分 类 处 理 消息 
switch (m.Classify) 
{ 

case 1: 
this .GetMessage (m); 
break; 

case 2: 
this.GetFile(m); 
break; 

Case 3: 
this.GetFriendRequest (m); 
break; 

case 4: 

case 5: 
this.GetFriendResponse (m); 
break; 


在 此 事件 处 理 程序 中 遍历 服务 器 响应 中 的 消息 列表 , 分 别 根据 消息 类 型 调用 不 同 的 方法 执 
行 不 同 的 操作 。 此 处 还 需要 有 4 个 扩展 方法 , 分 别 用 于 处 理 接收 到 文本 信息 、 文件、 好 友 请 求 、 
好 友 请 求 响 应 等 类 型 消息 的 消息 对 象 。 下 面 来 分 别 了 解 一 下 这 几 个 扩展 方法 。 


m=) >> 


件 


第 14 章 ”网 络 聊天 工具 | 


1) ”GetMessage0 方 法 
该 方法 用 于 把 接收 到 的 文本 消息 添加 到 窗 体 中 的 消息 列表 中 ， 具 体 实 现代 码 如 下 : 


// 获 取 文 本 消息 
private void GetMessage (WebServiceMessage.Messages msg) 
{ 
string m = msg.Sender + " 说 : \r\n "+ msg.Details; 
this.AddMessageToList (m); 
} 


2) ”GetFile0 方 法 

该 方法 用 于 接收 好 友 传 过 来 的 文件 消息 , 并 将 消息 中 的 字符 串 内 容 转 换 成 相应 的 二 进 制 文 
保存 到 用 户 磁 盘 中 。 实 现代 码 如 下 : 

// 获 取 文 件 


private void GetFile (WebServiceMessage.Messages msg) 
{ 
DialogResult dr = MessageBox.Show!( 
"好 友 "+ msg.Sender + "给 你 发 来 一 个 文件 (" + msg.FileFullName + 
"，Size:" + msg.Details.Length + "Byte)。\r\n 是 否 接收 该 文件 ? "， 
"接收 文件 "，MessageBoxButtons.YesNo); 
// 如 果 用 户 不 接收 该 文件 ， 放 弃 本 次 文件 传递 
if (dr != DialogResult.Yes) 
{ 


return; 


} 
// 设 置 文件 名 称 
string filename = this.GetNewFilename (msg.FileFullName); 
byte[] fileContent = ConvertSstringAndBytes. ConvertSstringToBytes 
(msg.Details); 
// 创 建 一 个 文件 流 对 象 ， 并 初始 化 
FileStream fs = new Filestream(filename, FileMode.OpenOrCreate); 
// 向 文件 流 中 写 入 内 容 
fs.Write (fileContent, 0, fileContent.Length); 
// 关 闭 流 
fs.Cclose(); 
上 


这 里 用 到 了 一 个 用 于 获取 用 户 设置 文件 名 的 方法 GetNewFilename()， 该 方法 代码 如 下 : 
// 设 置 接收 的 文件 的 文件 名 


private string GetNewFilename (string filename) 

{ 
// 设 置 一 个 本 地 文件 名 
OpenFileDialog ofd = new OpenFileDialog(); 
ofd.CheckFileExists = false; // 设 置 对 话 框 不 检查 文件 是 否 存在 
ofd.FileName = filename; // 设 置 【文件 名 】 文本 框 的 初始 值 
ofd.ShowDialog(); 
string fn = ofd.FileName; 


< 心 一 


TF (Fn SoBetring(ly 2) IE Ny 
{ 
MessageBox .Show ("选择 的 文件 名 格式 不 正确 ， 请 重新 选择 ! ") ; 


fn = this.GetNewFilename (filename); 


) 


return fn; 


} 


3) GetFriendRequest() 

该 方法 用 于 向 用 户 询问 好 友 请 求 的 处 理 方式 ， 并 向 服务 器 反馈 用 户 的 处 理 结果 。 有 具体 实现 
代码 如 下 : 

// 获 取 好 友 请 求 


private void GetFriendRequest (WebServiceMessage.Messages msg) 
下 
DialogResult result = MessageBox.Show( 
"用 户 "+msg.Sender+" 请 求 加 你 为 好 友 ， 是 否 同意 ? "， 
"好 友 请 求 "，MessageBoxButtons .YesNo) 7 
WsMessage.HandleFriendRequest (result == DialogResult.Yes, msg.Sender); 


} 


4) GetFriendResponse() 

处 理 好 友 请 求 响应 结果 的 方法 非常 简单 ， 只 需要 接收 相应 的 信息 ， 然 后 提示 用 户 处 理 结果 
即 可 。 该 操作 可 能 会 影响 用 户 好 友 的 列表 ， 所 以 在 方法 末尾 更 新 一 下 窗 体 中 的 用 户 列表 信息 。 
具体 实现 代码 如 下 : 

// 获 取 好 友 请 求 响应 

private void GetFriendResponse (WebServiceMessage.Messages msg) 


{ 
if (msg.Classify == 4) 


{ 
MessageBox .Show(" 用 户 " + msg.Sender + "同意 了 你 的 好 友 请 求 。"); 


} 
else 


{ 
MessageBox.Show ("用 户 " + msg.Sender + "拒绝 了 你 的 好 友 请 求 。"); 


} 
/7 刷新 好 友 列 表 


this.RefreshFriendList(); 


14.4 运行 结果 


首先 运行 Web 服务 项 目 ， 然 后 运行 两 次 客户 端 应 用 程序 ， 打 开 两 个 应 用 程序 窗口 ， 实 现 
信息 互 发 。 


Ed 人 > 
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， 在 客户 端 窗 体 项 目 Message 下 的 Bin 目录 下 的 Debug 目录 中 双击 Message.exe 应 
提示 | 用 程序 ， 就 可 以 运行 窗 体 程序 。 
单 击 【登录 】 窗 口中 的 【注册 】 按 钮 ， 打 开 【 用 户 注册 】 对 话 框 。 使 用 【用 户 注册 】 对 话 
框 注册 两 个 用 户 , 用 户 名 分 别 为 Tom 和 “ 李 丽 ”。 注册 成 功 后 系统 会 提示 注册 成 功 , 如 图 14-11 
所 示 。 
分 别 用 这 两 个 账户 登录 系统 ， 登 录 成 功 以 后 界面 如 图 14-12 所 示 。 


聊天 窗口 【当前 用 户 : Tom 


14-11 用 户 注册 成 功 14-12 ”聊天 程序 主 界面 


在 用 户 Tom 的 主 界面 中 单 击 【 添 加 好 友 】 按 钮 ， 打 开 【 添 加 好 友 】 对 话 框 ， 如 图 14-13 
所 示 。 

在 【用 户 名 】 文本 框 中 输入 要 请 求 的 好 友 的 名 字 “ 李 丽 ”， 然 后 单 击 【 发 送 请 求 】 按 钮 ， 
系统 会 自动 发 送 好 友 请 求 并 关闭 【添加 好 友 】 对 话 框 。 

与 此 同时 ， 用 户 “ 李 丽 ” 的 聊天 窗口 将 会 弹出 【好 友 请 求 】 确 认 框 ， 如 图 14-14 所 示 。 


世 聊天 窒 口 (当前 用 户 :Tom) ”聊天 容 口 《当前 用 广 。 地 而 


好 友 请 求 
用 户 Tom 请 求 加 你 为 好 友 ， 是 否 同意 ?了 


区 本 


图 14-13 【添加 好 友 】 对 话 框 14-14 【好 友 请 求 】 确 认 框 
单 击 【 是 】 按 钮 ， 接 受 该 次 好 友 请 求 。 
同时 ， 系 统 将 会 提示 Tom 用 户 已 同意 你 的 好 友 添加 请 求 ， 如 图 14-15 所 示 。 


单 击 【确定 】 按 钮 ， 关 闭 提示 对 话 框 ， 则 聊天 主 界面 的 好 友 列 表 中 将 自动 刷新 出 最 新 的 好 
友 列 表 信 息 ， 如 图 14-16 所 示 。 


乒 


让 


< 并 一 


也 聊天 可口 《当前 用 户 : Ton) E 国 聊天 容 口 (当前 用 户 : Ton) 


区 ] 


用 户 李 同意 了 你 的 好 友 语 永 。 
CC 要 


[Bm | [mz 支 ] 


14-15 ”提示 对 话 框 14-16 ”刷新 好 友 列 表 


以 同样 的 方式 ， 将 用 户 Tom 添加 到 用 户 “ 李 丽 ” 的 好 友 列 表 。 
在 用 户 “ 李 丽 ” 的 好 友 列 表 中 选中 好 友 Tom, 并 向 其 发 送 文本 消息 ,比如 输入 “Hello Tom!”， 


然后 单 击 【 发 送 】 按 钮 ， 系 统 会 成 功 发 送 这 条 信息 ， 结 果 如 图 14-17 和 图 14-18 所 示 。 


局 聊天 窗口 (当前 用 户 : 帮 丽 7 局 聊 天 罕 口 (当前 用 户 : Toa) 


El 
Malo Tong 


图 14-17 用 户 “ 李 丽 ”的 界面 图 14-18 用户 Tom 的 界面 
当然 ，Tom 也 可 以 向 “ 李 丽 ” 回 复 消息 ， 如 图 14-19 和 图 14-20 所 示 。 


聊天 窗口 (当前 用 户 : 帮 丽 ) 
休 卫 记 : 我 对 Tom 认 ; 
Hall Tong Melo reng 


斐 对 到 页 说 ; Tom 说 : 
Hollo 地图 Y hlle 地 而 4 


图 14-19 用 户 Tom 的 界面 14-20 ”用户 “ 李 丽 ”的 界面 
下 面 来 测试 发 送 文件 的 功能 。 在 用 户 “ 李 丽 ” 的 主 窗口 中 单 击 【 发 送 文件 】 按 钮 ， 在 弹出 


的 【打开 】 对 话 框 中 选择 一 个 文件 ， 然 后 单 击 【 打 开 】 按 钮 ， 系 统 会 询问 是 否 向 发 送 该 文件 ， 


如 图 14-21 所 示 。 


在 对 话 框 中 单 击 【是 】 按 钮 ， 系 统 会 发 送 该 文件 。 发 送 成 功 以 后 ， 用 户 Tom 的 窗口 中 就 


会 显示 “接收 文件 ”的 提示 信息 ， 如 图 14-22 所 示 。 


mm 人 >> 
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了 党 现 天 杏 口 (当前 用 户 : 才 画 ) | 又 焉 天 容 口 (当前 用 户 : Tox) 


[ER 于 而 这 
Tele Tont 


要 对 于 而 这 
Telle 地 丽 ? 


人 Tao ne smart 。 
[me Tum | EX 


14-21 【确认 发 送 】 对 话 框 14-22 【接收 文件 】 提 示 框 
单 击 【 是 】 按 钮 ， 确 认 接 收 该 文件 ， 并 在 弹出 的 对 话 框 中 选择 一 个 路 径 ( 比 如 这 里 将 文件 
保存 到 DD 盘 的 新 建文 件 夹 中 )。 


接收 以 后 就 可 以 在 Windows 资源 管理 器 中 使 用 预览 方式 查看 该 图 片 了 ， 如 图 14-23 所 示 。 


修 殉 日 期 ， 20L1 年 4 月 1 日 
1 


14-23 ”预览 图 片 
14.5 总 结 


本 章 介绍 的 网 络 聊天 工具 虽然 是 一 个 比较 简单 的 项 目 ， 但 也 比较 系统 地 对 Web 服务 的 一 
常用 技能 进行 了 一 次 练习 。 
通过 这 次 练习 , 我 们 对 Web 服务 有 了 更 加 深入 的 了 解 , 并 熟悉 了 使 用 Web 服务 请 求 数据 、 
使 用 Web 服务 发 送 文件 、 使 用 Web 服务 保存 状态 等 方面 的 技术 , 以 及 其 各 种 技术 的 综合 运用 。 
希望 大 家 能 通过 这 个 练习 学 到 一 些 知识 。 


虑 
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留言 簿 是 互联 网 上 最 常见 的 人 与 人 之 间 交 流 的 工具 ， 或 者 说 是 客户 与 商家 之 间 交 流 的 平 
台 。 留 言 簿 提供 了 一 个 信息 交流 的 空间 ， 客 户 可 以 通过 留言 簿 向 商家 提出 问题 ， 对 某 个 产品 发 
表 自己 的 看 法 。 

本 章 我 们 将 使 用 SQL Server 2008 结合 C# 语 言 来 制作 一 个 基于 Web 服务 的 ASP.NET 应 用 
程序 一 一 留言 簿 。 


学 习 目 标 : 

@ 掌握 留言 簿 的 基本 功能 

@” 热 悉 留 言 簿 的 基本 结构 

@@ ”掌握 创建 数据 库 表 的 方法 

@ 掌握 Web 网 站 的 创建 

@ 掌握 Web 服务 与 网 站 的 交互 


15.1 项 目 概 述 


本 章 我 们 开发 的 留言 簿 系统 的 功能 有 : 普通 用 户 可 以 浏览 全 部 留言 不 需 登录 就 可 以 发 表 
留言 ; 管理 员 登 录 后 可 以 对 留言 进行 管理 ， 包 括 回复 留言 及 删除 留言 等 。 本 留言 簿 系统 将 基于 
ASP.NET 和 Web 服务 来 开发 。 


15.1.1 功能 介绍 


经 常 上 网 的 朋友 对 于 留言 秒 可 能 并 不 防 生 。 留 言 秒 是 一 个 交流 平台 ,浏览 者 可 以 通过 留言 
敌 和 管理 者 进行 交流 。 浏 览 者 留 下 自己 的 相关 资料 和 意见 后 ， 这 些 内 容 会 被 保存 到 数据 库 中 ， 
并 且 能 够 读 取 到 页 面 上 。 留 言 秒 可 以 很 简单 也 可 以 很 复杂 ， 这 完全 由 开发 者 的 能 力 以 及 具体 情 
况 而 定 。 

本 系统 是 一 个 基本 的 简单 型 留言 短 ， 用 户 可 以 发 表 自己 的 看 法 和 意见 ， 也 可 以 查看 别人 的 
留言 ， 管 理 员 可 以 登录 后 对 留言 进行 回复 和 删除 。 

根据 以 上 分 析 ， 在 系统 中 留言 簿 的 基本 功能 主要 包括 如 下 3 个 部 分 。 

@ ”用 户 留言 : 用 户 在 网 站 中 浏览 时 ， 对 某 一 问题 发 表 自己 的 观点 和 看 法 ， 并 填写 个 人 的 

信息 ， 方 便 管理 员 与 其 他 人 员 相 互 交流 。 
@ ”查看 留言 : 网 站 管理 者 或 其 他 人 员 可 以 对 已 经 存在 的 留言 进行 查看 、 浏 览 ， 并 以 个 人 


观点 进行 评论 。 
@ 管理 留言 : 对 用 户 发 表 的 留言 进行 回复 和 删除 操作 ， 此 操作 只 有 在 管理 员 登 录 后 才 可 
以 进行 。 


15.1.2 ”结构 介绍 


根据 功能 分 析 ， 可 以 将 留言 短 划 分 为 首页 、 留 言 发 表 、 留 言 管理 和 登录 4 个 系统 模块 。 其 
中 ,留言 管 理 和 登录 这 两 个 系统 模块 由 管理 员 后 台 操作 时 使 用 。 留 言 短 的 4 个 系统 模块 及 其 功 
能 描述 如 表 15-1 所 示 。 


表 15-1 留言 簿 模块 


模 块 功 能 
首页 | 显示 所 有 留言 ， 管 理 员 还 可 以 对 其 中 的 留言 进行 回复 
留言 发 表 | 用 户 发 表 留 言 
留言 管理 | 管理 员 对 留言 进行 删除 或 查看 
登录 管理 员 登 录 
留言 簿 的 各 个 模块 均 由 一 个 或 多 个 页 面 来 实现 ， 如 表 15-2 所 示 展 示 了 各 个 页 面 文件 及 其 
功能 描述 。 
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表 15-2 留言 簿 页 面 文件 


模 块 功 能 


listMessage.aspx | 显示 所 有 留言 ， 管 理 员 登录 后 可 以 对 其 中 的 留言 进行 删除 操作 
addMessage.aspx | 用 户 发 表 留 言 

essage.aspx 管理 员 对 留言 进行 回复 操作 
Login.aspx 管理 员 登 录 


15.1.3” 自 定义 类 


为 了 提高 代码 的 利用 率 ， 减 少 代码 元 余 , 在 本 项 目 中 将 关于 访问 数据 库 的 操作 单独 写 入 一 
个 类 中 ， 命 名 为 DBHelper 类 。 该 类 中 关于 数据 库 连 接 字符 串 的 主要 实现 代码 如 下 所 示 : 
// 获 得 数据 库 连 接 


private static SqlConnection connection; 
public static SqlConnection Connection 
{ 
get 
{ 
string ConnectionString = "Data Source=.;Initial Catalog=message;User 
ID=sa;pwd=123"; 
if (connection == null) 
connection = new SqlConnection(connectionstring); 
connection.Open(); 
; 
else if (connection.State == System.Data.ConnectionState.Closed) 
{ 
connection.Open(); 
. 
else if (connection.State == System.Data.Connectionstate.Broken) 
{ 
connection.Close(); 
connection.Open(); 
} 


return connection; 


ExecuteCommand() 方 法 主要 用 于 增加 、 删 除 、 修 改 操作 ， 该 方法 同时 提供 一 个 重 载 方法 ， 
代码 如 下 : 

/// <summary> 

/// 执行 Sql 语句 ， 并 返回 受 影响 的 行 数 

/// </summary> 

/// <param name="safeSql"></param> 


< 


三 服务 开发 学 习 实录 


Eee 人 ) >> 


/// <returns></returns> 
public static int ExecuteCommand (string safesq]l) 
{ 
SqlCommand cmd = new SqlCommand(safeSql, Connection); 
int result = cmd.ExecuteNonQuery(); 
return result; 
} 
public static int ExecuteCommand(string sql, params SqlParameter[] values) 
{ 
SqlCommand cmd = new SqlCommand(sql, Connection); 
cmd.Parameters.AddRange (values); 
int result = cmd.ExecuteNonQuery (); 
return result; 


下 列 的 4 个 方法 主要 用 于 查询 时 调用 ， 返 回 不 同 的 结果 ， 代 码 如 下 : 


/// <summary> 

/// 执行 查询 ， 返 回 sqlDataReader 集合 

/// </summary> 

/// <param name="safeSql"></param> 

/// <returns></returns> 

public static SqlDataReader GetReader (string safeSsql) 

和 
SqlCommand cmd = new SqlCommand (safeSql，Connection) 7 
SqlDataReader reader = cmd.ExecuteReader () 7 
return reader; 


public static SqlDataReader GetReader (string sql, params SqlParameter[] values) 
{ 
SqlCommand cmd = new SqlCommand(sql, Connection); 
cmd.Parameters.AddRange (values); 
SqlDataReader reader = cmd.ExecuteReader () 7 
return reader; 


/// <summary> 
/// 执 行 查询 ， 返 回 Dataset 集合 
/// </summary> 
/// <param name="safeSqdl"></param> 
/// <returns></returns> 
public static DataSet GetDataSet (string safeSdql) 
{ 
DataSet ds = new DataSet (); 
SqlCommand cmd = new SqlCommand (safeSql, Connection); 
SqlDataAdapter da = new SqlDataAdapter (cmd); 
da.Fill (ds); 
return ds; 


public static DataSet GetDataSet (String sql, params SqlParameter[] values) 
{ 

DataSet ds = new Dataset () 7 

SqlCommand cmd = new SqlCommand(sql, Connection); 

cmd.Parameters.AddRange (values); 

SqlDataAdapter da = new SqlDataAdapter (cmd); 

da.Fill(ds); 

return ds; 


15.2 ”数据 库 设 计 


对 留言 短 进 行 结构 分 析 后 ， 就 要 开始 设计 用 于 存储 留言 信息 的 数据 库 了 。 本 系统 使 用 的 数 
据 库 是 SQL Server 2008， 数 据 库 名 message。 

由 于 留言 短 相 对 简单 ， 本 数据 库 包 括 两 个 表 ， 一 个 是 留言 信息 表 messageInfo， 一 个 是 管 
理 员 表 adminInfo。messageInfo 表 主 要 用 于 存储 留言 信息 ， 包 括 用 户 留言 和 管理 员 回复 信息 
adminInfo 表 存 储 的 是 管理 员 信息 , 包括 管理 员 名 称 和 密码 。 两 个 表 的 数据 结构 及 说 明 如 表 15-3 
和 表 15-4 所 示 。 


表 15-3 adminlnfo 表 


一 一 一 一 一 一 一 一 


| 管理 员 密码 


表 15-4 _ messagelnfo 表 


Varchar 
留言 主题 
留言 发 表 内 容 
发 表 人 联系 方式 


msgTitle Varchar 


msgContent varchar 


phohe 


varchar 


mail varchar 50 发 表 人 E-Mail 
isOnly int 4 表示 是 否 开 启 仅 管理 员 可 见 (0 否 1 是 ) 
addtime datetime 留言 发 表 时 间 


回复 内 容 


Varchar 


Tecontent 


< 


15.3 ”服务 器 端 设计 


项 目 结构 分 析 和 数据 库 设计 完成 后 ， 就 可 以 开发 项 目 了 。 我 们 在 服务 器 端 需要 实现 的 功能 
主要 有 显示 所 有 留言 、 管 理 员 登录 、 回 复 留言 和 删除 留言 等 。 


15.3.1 项 目 结构 


该 留言 簿 是 基于 Web 服务 的 ASPNET 项 目 ， 所 以 需要 用 一 个 Web 服务 项 目 来 实现 需求 。 
由 于 留言 簿 系统 涉及 数据 库 的 操作 ， 并 且 需 要 某 些 业务 逻辑 ， 所 以 这 里 使 用 三 层 架 构 的 设计 模 
式 来 实现 项 目 。 

创建 解决 方案 message， 然 后 在 解决 方案 里 添加 Web 服务 项 目 MessageWeb; 接着 创建 一 
个 用 于 封装 数据 实体 类 的 类 库 项 目 ， 命 名 为 model; 再 创建 一 个 用 于 封装 数据 访问 操作 的 类 库 
项 目 ， 命 名 为 DAL; 最 后 创建 用 于 封装 业务 逻辑 的 类 库 项 目 ， 命 名 为 BLL。 

该 留言 簿 系统 使 用 B/S 架构 设计 ， 所 以 还 需要 向 该 解决 方案 中 添加 ASP.NET 网 站 项 目 ， 
命名 为 message。 

全 部 创建 完成 后 ， 解 决 方案 资源 管理 器 中 的 结构 如 图 15-1 所 示 。 


15-1 解决 方案 资源 管理 器 结构 
当然 ， 创 建 好 项 目 后 不 要 忘 了 为 这 几 个 项 目 添 加 引用 关系 。BLL 引用 DAL 和 model; Web 
服务 项 目 MessageWeb 引用 BLL 和 model; ASPNET 项 目 message 引用 Web 服务 项 目 
MessageWeb。 
@ ”在 实际 开发 中 ， 一 般 只 有 大 型 项 目 才 使 用 三 层 架 构 的 设计 模式 来 实现 。 中 小 型 项 
各 未 | 。 目 可 根据 实际 需求 选择 性 地 使 用 三 层 架构 设计 模式 。 


15.3.2 ”管理 员 登 录 功 能 
在 名 称 为 BLL 的 类 库 项 目 中 添加 ManagerAdmin 类 文件 , 并 添加 用 于 管理 员 登 录 验 证 的 方 


法 GetAdmin, 输入 参数 为 管理 员 名 称 和 密码 ,返回 结果 为 Admin 实体 类 。GetAdmin 方法 表示 
根据 输入 的 用 户 名 和 密码 返回 一 个 对 象 ， 如 果 返 回 结果 为 空 ， 表 示 登 录 不 成 功 ; 如 果 返 回 结果 
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非 空 ， 表 示 用 户 登 录 成 功 ， 将 登录 信息 读 取出 来 并 保存 到 初始 化 的 Admin 实体 类 中 ， 然 后 返 
回 结果 。 具 体 代码 如 下 所 示 : 


/// <summary> 
/// 查看 当前 登录 管理 员 是 否 存 在 
/// </summary> 
/// <param name="name"> 参 数 用 户 名 </param> 
/// <param name="pwd"> 参 数 密码 </param> 
/// <returns> 返 回 结果 </returns> 
public admin GetRAdmin (string name, string pwd) 
admin a = new admin(); 
SqlDataReader dr = dal.GetAdmin (name, pwd); 
if (dr.Read()) 
{ 
a.Id = Convert.ToInt32 (dr["id"]); 
a.AdminName = dr["adminname"] .ToString(); 
a.PassWord = dr["password"] .ToString() 7 
dr-Close()? 
return a; 
} 
else 
{ 
dr.Cclose(); 
return null; 


} 

该 方法 中 的 “dal” 为 ServiceAdmin 类 的 实例 化 。ServiceAdmin 类 位 于 数据 访问 层 DAL， 
表示 和 数据 库 的 交换 信息 。 

同时 ， 我 们 还 要 在 Web 服务 adminWebService 下 面 添加 验证 用 户 登 录 的 方法 ， 代 码 如 下 
所 示 : 


[WebMethod] 
/// <summary> 
/// 查看 当前 登录 管理 员 是 否 存在 
/// </summary> 
/// <param name="name"> 参 数 用 户 名 </param> 
/// <param name="pwd"> 参 数 密码 </param> 
/// <returns> 返 回 结果 </returns> 
public admin GetAdmin (string name, string pwd) 
{ 

admin a = admin.GetAdmin (name, pwd); 

if (a != null) 

| 

return a; 
} 
else 


{ 
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return null; 


注意 ， 在 Web 服务 中 添加 的 方法 前 需要 添加 “[WebMethod]”， 这 样 ， 该 方法 才能 在 Web 


中 进行 访问 ， 否 则 该 方法 无 效 。 


15.3.3 ”添加 留言 


在 数据 访问 层 ServiceMessage 类 中 的 添加 留言 的 方法 名 称 为 add， 输 入 参数 为 message 实 


体 类 ， 返 回 值 为 int 类 型 ， 即 执行 SQL 语句 后 返回 的 受 影响 的 行 数 。 实 现代 码 如 下 所 示 : 


/// <summary> 
/// 添加 一 条 留言 
/// </summary> 
/// <param name="message"></param> 
/// <returns></returns> 
public int add (message message) 
{ 
string sql = "INSERT INTO messageInfo (name, msgTitle, msgContent, phone, 
mail, isOnly,datetime,recontent) VALUES 
(@name, @title,@content, @phone, @mail,@isonly,@datetime,@recontent)"; 
SqlParameter[] para = new SqlParameter[]{ 
new SqlParameter ("@name",message.Name), 
new SqlParameter("@title",message.MsgTitle), 
new SqlParameter("@content",message.MsgContent), 
new SqlParameter ("@phone",message.Phone), 
new SqlParameter("@mail",message.Mail), 
new SqlParameter("@isonly",message.isOnly), 
new SqlParameter("@datetime",message.Datetime), 
new SqlParameter("@recontent",message.Recontent), 
] 7 
try 
{ 
return DBHelper.ExecuteCommand (sql, para); 
1 
catch (Exception e) 
{ return 0; } 


E 
在 业务 逻辑 层 BLL 中 ，ManagerMessage 类 添加 对 添加 留言 的 操作 代码 ， 方 法 名 为 add， 


如 下 所 示 : 
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/// <summary> 

/// 添加 一 条 留言 

/// </summary> 

/// <param name="message"></param> 
/// <returns></returns> 

public int add(message message) 


{ 


return dal.add (message); 


} 


在 add 方法 中 的 dal 为 数据 访问 层 ServiceMessage 类 的 实例 化 ， 然 后 调用 ServiceMessage 
类 的 添加 留言 方法 ， 因 为 这 两 个 方法 定义 的 返回 值 相同 ， 所 以 可 以 直接 返回 结果 。 


同样 ， 


[WebMethod 


还 需要 在 Web 服务 中 实现 add 方法 , 在 Web 服务 messageService 中 添加 如 下 代码 : 


/// <summary> 

/// 添加 一 条 留言 

/// </summary> 

/// <param name="message"></param> 
/// <returns></returns> 

public int add (message message) 


{ 


return new BLL.ManagerMessage() .add (message); 


} 


15.3.4 


获得 留言 列表 


添加 留言 时 , 可 以 选择 是 否 开 启 仅 管理 员 可 见 , 在 数据 库 中 表示 该 项 功能 的 字段 是 isOnly， 
功能 描述 为 是 否 开启 仅 管理 员 可 见 (0 表示 否 ，1 表示 是 )。 所 以 ， 在 获得 留言 列表 时 ， 有 两 种 形 
式 : 当 管 理 员 登 录 时 ， 将 所 有 留言 按照 时 间 的 先后 顺序 读 取 , 当 普 通用 户 浏览 留言 时 ， 将 显示 
isOnly 字段 为 0 的 所 有 留言 。 
在 ManagerMessage 中 添加 代码 用 来 实现 获得 留言 列表 ， 代 码 如 下 : 
/// <summary> 
/// 获得 所 有 留言 信息 
/// </summary> 


/// <returns></returns> 
public DataSet GetMessage () 


string sql = "select * from messageInfo order by datetime desc"; 
return dal.GetMessage (sql); 


. 


/// <summary> 

/// 获得 没有 限制 管理 员 可 见 的 所 有 留言 

/// </summary> 

/// <returns></returns> 

public DataSet GetMessageBYIsRead () 


:| 


string sql = "select * from messageInfo where isonly=0 order by datetime 


desc” 


return dal.GetMessage (sql); 


, 
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我 们 定义 了 两 个 方法 GetMessage 和 GetMessageByIsRead。 方法 GetMessage 表示 获得 所 有 
留言 ， 方 法 GetMessageByIsRead 表示 如 果 是 普通 用 户 查看 留言 ， 那 么 仅 显 示 isOnly 标记 为 0 
的 留言 ， 标 记 为 1 的 留言 表示 仅 管 理 员 可 见 。 

在 ManagerMessage 类 中 的 方法 里 出 现 的 dal 则 是 ServiceMessage 类 的 实例 化 对 象 , Service 
Message 位 于 数据 访问 层 。ServiceMessage 类 中 的 GetMessage 方法 的 实现 代码 如 下 所 示 : 


/// <summary> 
/// 获得 所 有 留言 信息 
/// </summary> 
/// <returns></returns> 
public DataSet GetMessage (string sql) 
{ 
Dataset ds = new Dataset(); 
try 
{ 
ds = DBHelper.GetDataSet (sql); 
return ds; 
} 
catch (Exception e) 
{ 
return null; 
} 
} 


在 ServiceMessage 类 中 GetMessage 方法 接收 的 参数 为 一 条 SQL 查询 语句 ， 返 回 一 个 
DataSet 集合 。 

同样 地 , 我 们 还 需要 在 Web 服务 中 实现 业务 逻辑 层 ManagerMessage 类 中 定义 的 两 个 查询 
方法 。 在 Web 服务 messageService 里 添加 如 下 代码 : 


[WebMethod] 
// 获 得 留言 列表 
public DataSet GetAllMessage (int isOonly) 
{ 
if (isOonly == 1) 
{ 
return new BLL.ManagerMessage() .GetMessage(); 
} 
else if (isOonly == 0) 
{ 
return new BLL.ManagerMessage() .GetMessageByIsRead(); 
1 
else 
{ 
return null; 
} 
¥ 


在 GetAllIMessage 方法 中 ， 参数 isOnly 用 来 表示 当前 的 登录 状态 。 当 isOnly 为 1 时 ,表示 
为 登录 状态 ， 调 用 函数 获得 所 有 留言 信息 ; 当 isOnly 为 0 时 ， 表 示 未 登录 状态 ， 调 用 函数 获得 
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所 有 isOnly 标记 为 0 的 留言 信息 。 数 据 库 中 的 isOnly 字段 只 有 0 和 1 两 个 值 ， 如 果 参 数 为 其 
他 ， 则 返回 一 个 空 值 。 


15.3.5 “管理 留言 功能 


Ee 


管理 员 对 留言 的 管理 包括 对 留言 进行 删除 和 回复 两 个 功能 。 

在 数据 访问 层 DAL 的 ServiceMessage 类 中 ， 定 义 了 删除 方法 DelMessage 和 回复 方法 
AddRegMsg。 删除 方法 DelMessage 接收 参数 留言 ID, 返回 执行 SQL 语句 后 受 影响 的 行 数 。 回 
复方 法 AddRegMsg 接收 参数 message 实体 类 ， 根 据 留言 ID 更 新 数据 表 recontent 的 内 容 ， 返 
回执 行 SQL 语句 后 受 影响 的 行 数 。 

位 于 数据 访问 层 DAL 的 ServiceMessage 类 的 具体 实现 代码 如 下 所 示 : 

/// <summary> 

/// 添加 回复 

/// </summary> 

/// <returns></returns> 


public int AddRegMsg (message message) 
:| 


string sql = "UPDATE messageInfo SET recontent =@recontent WHERE (ID = @id)"; 
Lh 
{ 
SqlParameter[] para = new SqlParameter[] { 
new SqlParameter("@recontent",message.Recontent), 
new SqlParameter ("@id",message.Id) 
}; 
return DBHelper.ExecuteCommand (sql, para); 
} 
catch (Exception e) 
{ return 0; } 


} 


/// <summary> 
/// 删除 留言 
/// </summary> 
/// <param name="id"></param> 
/// <returns></returns> 
public int DelMessage (int id) 
{ 
string sql = "DELETE FROM messageInfo WHERE (ID = @id)"7 
try 
{ 
return DBHelper.ExecuteCommand(sql, new SqlParameter("@id", id)); 
上 
catch (Exception e) 
{ return 0; } 


< 
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接 下 来 是 在 业务 逻辑 层 的 实现 。 在 ManagerMessage 中 添加 实现 代码 ， 如 下 所 示 : 


/// <summary> 

/// 删除 留言 

/// </summary> 

/// <param name="id"></param> 

/// <returns></returns> 

public int DelMessage (int id) 

| 
return dal.DelMessage (id); 

. 

/// <summary> 

/// 添加 回复 

/// </summary> 

/// <returns></returns> 

public int AddRegMsg (message message) 
return dal.AddRegMsg (message); 

:| 


同样 地 ， 还 需要 在 Web 服务 messageService 中 添加 如 下 代码 : 


[WebMethod] 
/// <summary> 
/// 添加 回复 
/// </summary> 
/// <returns></returns> 
public bool AddRegMsg (message message) 
. 
int num = new BLL.ManagerMessage() .AddRegMsg (message); 
if (num != 0) 
3 
return true; 
} 
else 


{ 


return false; 


} 
[WebMethod] 
/// <summary> 
/// 删除 留言 
/// </summary> 
/// <param name="id"></param> 
/// <returns></returns> 
public bool DelMessage (int id) 
{ 
int num = new BLL.ManagerMessage() .DelMessage (id); 
if (num != 0) 


{ 


return true; 
} 
else 
{ 

return false; 


} 


15.4 ”客户 端 设计 


该 留言 簿 系统 使 用 的 客户 端 是 ASP.NET 网 站 项 目 。 之 前 的 章节 中 ， 通 过 结构 介绍 了 解 到 
客户 端 共 有 4 个 页 面 ,分别 是 listMessage.aspx、addMessage.aspx、regMessage.aspx 和 Login.aspx。 


15.4.1 添加 留言 
在 添加 留言 页 面 addMessage.aspx 中 ， 需 要 添加 到 数据 库 中 的 数据 有 用 户 昵 称 、 留 言 主题 、 


留言 内 容 、 联 系 电话 、 电 子 邮 箱 这 几 项 ， 还 有 一 个 单 选 按钮 ， 表 示 该 条 留言 是 否 开启 仅 管理 员 
可 见 ， 如 图 15-2 所 示 。 


有 数 于 格式 不 正 稍 固 活 为 7 或 位， 手机 号 码 为 1 位 ) 
格式 插 齐 


rea a 交 | 
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图 15-2 添加 留言 页 面 


在 这 里 ， 留 言 内 容 使 用 的 是 TextBox 控件 ， 需 要 将 TextBox 控件 的 TextMode 属性 改 为 
“MultiLine”。【 仅 管理 员 可 见 】 复 选 框 默认 不 启用 。 

为 了 防止 有 人 恶意 添加 留言 , 导致 系统 崩溃 , 我 们 还 需要 添加 数据 验证 ,可 以 使 用 ASP.NET 
提供 的 验证 控件 进行 验证 。 

了 昵称、 主题 、 内 容 这 三 项 输入 的 信息 使 用 RequiredFieldValidator 非 空 验证 控件 。 为 了 防止 
用 户 留 下 不 完整 的 信息 ， 使 用 非 空 验证 控件 用 来 验证 当 用 户 提交 时 输入 的 信息 是 否 为 空 。 

电子 邮箱 使 用 RegularExpressionValidator 验证 控件 ， 也 称 为 正则 表达 式 验证 控件 ， 它 用 来 
验证 电子 邮箱 输入 的 格式 是 否 正确 。 正则 表达 式 控件 的 ValidationExpression 属性 可 以 用 来 输入 


< 


正则 表达 式 ， 系 统 默 认 的 有 验证 邮箱 的 正则 表达 式 ， 当 然 ， 我 们 也 可 以 自己 写 正 则 表达 式 。 
联系 方式 同样 使 用 RegularExpressionValidator 正则 表达 式 验证 控件 ,用 来 验证 输入 的 联系 
电话 号 码 是 否 符合 要 求 。 
输入 的 内 容 都 通过 验证 后 ， 执 行 提交 按钮 的 单 击 事件 ， 代 码 如 下 : 


protected void Button]l Click(object sender, EventArgs e) 
| 
// 提 交 留 言 
message model = new message(); 
model.Name = txtName.Text.Trim(); 
model.MsgTitle = txtTitle.Text.Trim(); 
model.MsgContent = txtContent.Text.Trim(); 
model.Phone = txtPhone.Text.Trim(); 
model.Mail = txtMail.Text.Trim(); 
model.Datetime = DateTime.Now; 
model .Recontent = " 暂 无 回复 "; 
/1/0 表示 否 ，1 表示 是 
if (CheckBoxl.Checked) 
| 
model.isOonly = 1; 
} 
else 
{ 
model.isOonly = 0; 

} 
WebMessage.messageService msg = new WebMessage.messageService(); 
if (msg.add(model) > 0) 
A 

// 回 到 留言 列表 

Response.Redirect ("listMessage.aspx"); 
} 
else 
‘| 

Page.ClientScript.RegisterStartupScript (this.GetType(), "", 

"<script>alert (' 添 加 失败 ! ')</script>"); 
) 
了 


使 用 的 添加 方法 来 自 Web 服务 messageService ， 添 加 成 功 后 ， 页 面 直接 跳 转 到 
ListMessage.aspx 主页 面 。 


15.4.2 ”管理 员 登 录 
Login.aspx 页 面 用 于 管理 员 登 录 ， 前 台 页 面 布局 包括 两 个 文本 框 和 一 个 按钮 ， 文 本 框 分 别 


命名 为 txtAdmin 和 txtPwd， 用 来 输入 管理 员 名 称 和 密码 。 单 击 【 登 录 】 按 钮 ， 根 据 用 户 名 和 
密码 查看 数据 库 是 否 存在 该 用 户 ， 代 码 如 下 所 示 : 


mi >> 


protected void Button1l Click(object sender, EventArgs e) 
{ 
WebAdmin.adminWebService a = new WebAdmin.adminWebService(); 
admin admin = a.GetAdmin (txtAdmim.Text, txtPwd.Text); 
if (admin != null) 
| 
Session["admin"] = admin; 
Response.Redirect ("listMessage.aspx"); 
} 
else 


i 


Page.ClientScript.RegisterStartupScript (this.GetType(), "" 
"<script>alert (' 登 录 失 败 ， 用 户 名 或 密码 错误 ! ')</script>"); 


了 


} 


在 按钮 的 单 击 事件 中 使 用 Web 服务 adminWebService 提供 的 方法 GetAdmin， 如 果 存 在 该 
用 户 ， 则 需要 保存 到 Session 中 ， 并 且 转 到 listMessage.aspx 页 面 。 


15.4.3 ”显示 和 管理 留言 


listMessage.aspx 页 面 是 主页 面 ， 如 果 在 未 登录 状态 下 浏览 该 页 面 ， 则 只 显示 数据 库 中 所 有 
的 留言 信息 ， 如 果 管 理 员 登 录 ， 则 会 显示 删除 和 回复 功能 。 页 面前 台布 局 如 图 15-3 所 示 。 


2 邦和 5 几 ; 到 和 师 定 


主题 : 光 据 甸 定 发 在 : 歼 电 定 


[ED 


15-3 listMessage.aspx 页 面 布局 
1. 显示 留言 


在 页 面 的 Load 事件 里 ， 绑 定 显示 所 有 留言 信息 ， 并 且 判 断 是 否 有 管理 员 登 录 ， 如 果 管 理 
员 登 录 ， 那 么 将 显示 管理 员 的 名 称 ， 代 码 如 下 : 
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WebAdmin.admin admin = new WebAdmin.admin(); 
WebMessage.messageService webmessage = new WebMessage.messageService(); 
protected void Page Load (object sender, EventArgs e) 
{ 
if (!IsPostBack) 
{ 
BindData() ; // 绑 定数 据 


if (Session["admin"] != null) 

{ 
lbtnamdin.Visible = false; 
lbladmin.Visible = true; 
admin = (admin)Session["admin"]7 
lbladmin.Text = admin.AdminName; 


} 

在 Load 事件 中 ， 首先 绑 定数 据 ， 然 后 根据 Session 是 否 为 空 来 判断 管理 员 是 否 登录 。 如 果 
不 为 空 ， 则 表示 管理 员 已 登录 ， 设 定 管理 员 登 录 按 钮 lbtnamdin 隐藏 ， 标 签 lbladmin 显示 ， 并 
且 从 Session 中 读 取出 管理 员 信息 ， 并 将 管理 员 名 称 显 示 到 标签 lbladmin 上 。 

BindData 为 绑 定 数据 的 自 定义 方法 ， 代 码 如 下 : 


private void BindData() 


{ 


Dataset ds = null; 
int isOnly = 07 
if (Session["admin"] != null) 


{ 
isonly = 1;// 开 启 仅 管理 员 可 见 ， 表 示 获 得 所 有 留言 信息 

} 
ds = webmessage.GetAllMessage (isOnly); 
PagedDataSource pds = new PagedDataSource(); 
pds.DataSource = ds.Tables[0] .DefaultView; 
pds.AllowPaging = true; 
AspNetPagerl.RecordCount = pds.Count; 
pds.CurrentPageIndex = AspNetPagerl.CurrentPageIndex - 1; 
pds.PageSize = AspNetPagerl]l .PageSize; 
listRepeater.DataSource = pds; 
listRepeater.DataBind(); 

} 


自 定义 局 部 变量 isOnly， 类 型 为 int， 默 认 值 为 0。 当 管理 员 登 录 时 ， 将 isOnly 赋值 为 1， 
将 变量 isOnly 作为 参数 传 给 方法 GetAllIMessage， 定 义 于 Web 服务 的 该 方法 , 根据 传 入 值 的 不 
同 ， 获 得 不 同 的 数据 集 。 

在 BindData 方法 中 , 添加 了 分 页 功能 ， 在 这 里 使 用 了 AspNetPager 分 页 控件 。 控件 的 前 台 
代码 如 下 所 示 : 
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<webdiyer:AspNetPager ID="RAspNetPager1"” runat="server" 
onpagechanged="AspNetPager] PageChanged" AlwaysShow="True" 
FirstPageText=" 首页 " LastPageText=" 尾 页 ”NextPageText=" == 
PageIndexBoxType="DropDownList" PageSize="5" PrevPageText=" 上 一 页 "> 
</webdiyer:AspNetPager> 


使 用 该 控件 要 注意 ， 需 要 实现 AspNetPager 控件 的 PageChanged 事件 ， 在 该 事件 中 
定 BindData 方法 。 代 码 如 下 所 示 : 


protected void AspNetPagerl_ PageCchanged (object sender, EventArgs e) 
{ 


BindData(); 
} 


或 者 也 可 以 实现 AspNetPager 控件 的 PageChanging 事件 , 在 该 事件 中 则 需要 多 添加 一 行 代 
码 ， 代 码 如 下 所 示 : 


protected void RspNetPager1l_PageCchanging(object src, 
Wuqi .Webdiyer.PageChangingEventArgs e) 
{ 
AspNetPagerl .CurrentPageIndex = e.NewPageIndex; 
BindData (); 


2. 管理 留言 
显示 留言 列表 信息 使 用 的 是 Repeater 数据 控件 ， 前 台 代 码 如 下 : 


<asp:Repeater runat="server" ID="listRepeater" 
onitemdatabound="listRepeater ItemDataBound" 
onitemcommand="listRepeater ItemCommand" > 
<ItemTemplate> 
<table width="650" cellpadding="8" cellspacing="]1" bgcolor="#a9cfe4"> 

<tr> 

<td width="150"” > 上 昵称: <%#Eval ("name") %></td> 

<td> 主 题 : <%#Eval ("msgtitle") %></td> 

<td> 发 表 时 间 : <%#Eval ("datetime") %></td> 

</tr> 
<tr> 

<td width="150" colspan="3"> 内 容 : &nbsp; <br/> 

&nbsp; tnbsp; <%#Eval ("msgcontent") %></td> 

</tr> 

<tr> 

<td width="150" colspan="3"> 回 复 内 容 : &nbsp; <br/> 

&nbsp; gnbsp; <%#Eval ("recontent") %></td> 

</tr> 

~ 

<td colspan="3" align="right"> 

<asp:LinkButton ID="lbtnDel" runat="server" CommandName="del™" 
CommandArgument='<%#Eval ("id") %>' Visible="false"> 删 除 
</asp:LinkButton>gnbsp; 
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<asp:LinkButton ID="lbtnrep" runat="server" CommandName="huin” 
CommandArgument="'<%#Eval ("id") %>"' Visible="false"> 回 复 </asp:LinkButton> 
<br/> 
&nbsp; Enbsp; </td> 
</tr> 
</table> 
</ItemTemplate> 
</asp:Repeater> 


在 Repeater 控件 里 放 入 的 删除 和 回复 按钮 ，Visible 属性 默认 为 不 显示 ， 按 钮 的 
CommandName 属性 分 别 设置 为 “del” 和 “hui”， 用 于 在 Repeater 控件 的 IemCommand 事件 
里 区 分 两 个 控件 。 按钮 的 CommandArgument 属性 绑 定 的 是 留言 id。ItemCommand 事件 的 代码 
如 下 所 示 : 


protected void listRepeater ItemCommand (object source, 


EE 


RepeaterCommandEventArgs e) 


{ 


if (e.CommandName == "del") 


{ 
if (bll.DelMessage (Convert.ToInt32(e.CommandArgument)) > 0) 


{ 


mm 


Page.ClientScript.RegisterStartupScript (this.GetType(), 
"<script>alert (' 删 除 成 功 ! ')</script>"); 
BindData (); 

} 


else 


{ 


mm 
了 


Page.ClientScript.RegisterStartupScript (this.GetType(), 
"<script>alert (' 删 除 失 败 ! ')</script>"); 
上 


if (e.CommandName == "hui") 


int id = Convert.ToInt32(e.CommandArgument); 
Response.Redirect ("regMessage.aspx?id=" + id); 


} 


在 ItemCommand 事件 里 ，“e” 表 示 Repeater 控件 本 身 ， 使 用 CommandName 属性 找到 定 
义 的 两 个 值 ， 然 后 进行 判断 ， 如 果 是 “del”， 那 么 进行 删除 操作 ， 删 除 成 功 重新 绑 定数 据 ， 删 
除 方法 的 参数 从 CommandArgument 属性 获取 。“hui” 表 示 回 复 操作 ， 页 面 直 接连 接 到 
regMessage.aspx 页 面 ， 并 且 将 参数 id 通过 Request 方式 传递 到 该 页 面 。 

在 这 里 ， 因 为 使 用 的 方法 都 是 Web 服务 提供 的 ， 所 以 ， 如 果 有 方法 返回 的 是 实体 类 ， 接 
收 时 引用 的 命名 空间 不 能 是 在 解决 方案 中 的 类 库 项 目 model 里 的 admin 类 ， 而 是 要 引用 
WebAdmin， 才 能 保证 程序 的 正确 性 。 

因为 将 管理 和 浏览 留言 放 在 了 同一 页 面 ， 所以， 需要 判断 当前 管理 员 是 否 登 录 ， 然 后 才能 
复 和 删除 功能 。 这 一 判断 需要 在 Repeater 控件 的 IemDataBound 事件 里 进行 ， 它 表示 在 


互 


显示 
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数据 绑 定 后 激发 ， 具 体 代码 如 下 : 


protected void listRepeater ItemDataBound (object sender, 
RepeaterItemEventArgs e) 
和 
if (Session["admin"] != null) 
1 
// 如 果 管 理 员 登 录 ， 显 示 编 辑 项 


LinkButton lbtnDel = (LinkButton)e.-Item.FindControl("1btnDel") 7 
LinkButton lbtnrep = (LinkButton)e.Item.FindControl ("lbtnrep"); 


lbtnDel .Visible = true; 
lbtnrep.Visible = true; 
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需要 注意 的 是 Repeater 控件 的 两 个 事件 : ItemDataBound 事件 和 ItemCommand 事件 。 经 常 
会 有 人 混淆 这 两 个 事件 ， 不 知道 什么 时 候 要 用 哪个 事件 。 其 实 很 简单 ，ItemDataBound 事件 是 
在 数据 绑 定 时 激发 ， 从 英语 的 语法 来 讲 ， 它 是 一 个 进行 式 ， 当 数据 全 部 绑 定 结束 ， 该 事件 也 完 
成 了 。 而 ItemCommand 事件 则 是 在 数据 绑 定 结束 后 ， 简 单 来 讲 就 是 一 个 过 去 式 ， 激 发 控件 中 


任 一 按钮 时 触发 该 事件 ， 有 具体 表现 在 对 数据 进行 增 、 删 、 改 操作 时 ， 需 要 在 该 事件 中 进行 。 


15.4.4 回复 留言 


在 单 击 回复 留言 时 ， 页 面 会 跳 转 到 回复 留言 页 面 regMessage.aspx 进行 操作 。 


首先 ， 要 注意 回复 功能 只 有 管理 员 登 录 后 才能 操作 ， 所 以 要 对 该 页 面 进行 验证 。 在 


regMessage.aspx 页 面 的 Load 事件 里 添加 如 下 代码 : 


WebMessage.messageService webmessage = new WebMessage.messageService(); 


protected void Page_Load (object sender, EventArgs e) 
{ 
if (!IsPostBack) 


{ 
if (Session["admin"] != null) 
{ 
if (Request["id"] != null) 
{ 
int messageId = Convert.ToInt32 (Request["id"]); 
message msg = webmessage.GetMessageById (messageId); 
lblTitle.Text = msg.MsgTitle; 
lblName.Text = msg.Name; 
} 
else 
{ 
Response.Redirect ("Login.aspx"); 
上 
| 
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判断 Session 是 否 为 空 ， 不 为 空 时 表示 当前 管理 员 为 登录 状态 ， 否 则 转 到 登录 页 面 进行 登 
录 。 其 次 ， 接 收 从 listMessage.aspx 页 面 传递 过 来 芯 5 参数 ， 最 后 ， 显 示 对 要 回复 的 留言 的 相关 


息 
恩 。 


信和 


了 


互 


复方 法 调用 的 是 Web 服务 messageService 提供 的 方法 AddRegMsg， 在 回复 按钮 的 单 击 
事件 里 代码 如 下 所 示 : 


protected void Buttonl Click(object sender, EventArgs e) 
{ 


// 回 复 
if (Request["id"] != null) 
{ 
message msg = new message(); 
msg.Id = Convert.ToInt32 (Request["id"]); 
msg.Recontent = txtcontent.Text; 
if (webmessage.AddRegMsg (msg)) 
{ 
// 回 复 成 功 直 接 转 回 留言 列表 
Response.Redirect ("listMessage.aspx"); 
} 
else 
{ 
Bage.ClientScript.RegisterStartupScript (this.GetType(), "", 
"<script>alert (' 回 复 失败 ! ')</script>"); 


} 
根据 AddRegMssg 方法 返回 的 值 判断 回复 留言 是 否 成 功 ， 成 功 后 直接 转 回 listMessage.aspx 


15.5 运行 效果 


运行 listMessage.aspx 页 面 ， 在 未 登录 时 浏览 该 页 面 ， 如 图 15-4 所 示 。 
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15-4 listMessage.aspx 初始 页 面 
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单 击 【 发 表 留言 】 链接， 跳 转 到 addMessage.aspx 页 面 ， 添 加 一 条 数据 并 选择 仅 管理 员 
可 见 ， 如 图 15-5 所 示 。 


二 个 量 言 天 实现 的 控 坟 是 什么 


: 
:Eee 


Esesrn [EJ] 


图 15-5 添加 留言 页 面 
提交 后 页 面 转 回 listMessage.aspx 页 面 ， 且 该 条 留言 未 显示 。 
单 击 【管理 员 登 录 】 链 接 ， 使 用 管理 员 账 号 登录 ， 如 图 15-6 所 示 ， 用 户 名 和 密码 分 别 是 


admin 和 admin， 登 录 后 转 到 listMessage.aspx 页 面 。 这 时 ， 删 除 和 回复 功能 在 页 面 显示 ， 如 
图 15-7 所 示 。 
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图 15-7 管理 员 登 录 后 的 listMessage.aspx 页 面 


< 


这 时 ， 我 们 开始 添加 的 那 条 昵称 为 “ 嘻 嘻 ” 的 留言 显示 在 页 面 上 ， 单 击 【 回 复 】 链 接 ， 转 
到 regMessage.aspx 页 面 ， 管 理 员 进行 回复 ， 如 图 15-8 所 示 。 
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15-8 回复 页 面 


管理 员 提 交 后 ， 回 到 listMessage.aspx 页 面 。 
选择 昵称 为 “哈哈 ”的 留言 ， 单 击 【 删 除 】 链 接 ， 进 行 删除 操作 ， 删 除 结果 如 图 15-9 
所 示 。 


EL HTL 发 静电 则 ; 2011-4-15 17:04:28 
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WN EE 
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t 图 15-9 删除 操作 
15.6 总 结 


到 这 里 ， 本 章 所 介绍 的 留言 簿 系统 就 完成 了 。 因 为 不 是 专业 美工 ， 所 以 界面 可 能 没有 网 上 
的 那些 留言 敌 华 丽 ， 但 是 留言 秒 要 求 的 基本 功能 我 们 还 是 大 致 完成 了 。 

在 这 里 ,我们 所 实现 的 留言 簿 系统 只 是 完成 了 一 些 简单 的 基本 功能 ， 有 兴趣 的 读者 可 以 根 
据 具体 的 业务 需求 进行 功能 扩展 。 

通过 本 案例 的 开发 ， 我 们 可 以 更 加 深刻 地 了 解 Web 服务 的 实际 应 用 。 同 时 了 解 开发 一 个 
完整 项 目 所 需要 的 具体 步骤 ， 加 深 读者 对 软件 开发 的 认识 。 
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